Index der Dokumentation

Hauptdokumentation

Dokumentation für Entwickler

  • API-Referenz - Öffentliche API-Dokumentation. Umfasst Metadatenverwaltung, Navigationssteuerung und Ereignisabonnements für JavaScript/TypeScript-Entwickler.
  • Theming-Leitfaden - Leitfaden für Theme-Entwickler. Enthält eine CSS-Klassenreferenz, benutzerdefinierte Eigenschaften und Themenbeispiele für helle und dunkle Modi.
  • Startup-Prozess - Plugin-Initialisierungssequenz. Cold-Boot- und Warm-Boot-Abläufe, Metadaten-Cache-Auflösung, aufgeschobene Bereinigung und Inhaltsgenerierungs-Pipeline. Enthält Mermaid-Diagramme.
  • Metadaten-Pipeline - Cache-Wiederaufbaureihenfolge, Stufen der Anbieter-Pipeline und Abschlusssignale. Enthält Mermaid-Diagramme.
  • Speicherarchitektur - Leitfaden für Speichercontainer (IndexedDB, lokaler Speicher, Memory Cache, Einstellungen). Datenflussmuster und Nutzungsrichtlinien.
  • Rendering-Architektur - React-Komponentenhierarchie, virtuelles Scrollen mit TanStack Virtual, Leistungsoptimierungen und Datenfluss.
  • Orchestrierung des Scrollens - Wie das Plugin bei Änderungen der Baumstruktur (Sichtbarkeit von Tags, Einstellungen usw.) einen genauen Bildlauf gewährleistet
  • Dienst-Architektur - Geschäftslogik-Schicht: MetadataService, FileSystemOperations, ContentProviderRegistry. Muster für die Injektion von Abhängigkeiten und Dienstdatenfluss.

1 Installation

  1. Obsidian installieren - Herunterladen und installieren von obsidian.md
  2. Aktivieren Sie Community-Plugins - Gehen Sie zu Einstellungen → Community-Plugins → Aktivieren Sie Community-Plugins
  3. Notebook Navigator installieren - Klicken Sie auf "Durchsuchen" → Suchen Sie nach "Notebook Navigator" → Installieren
  4. Installieren Sie Style Settings (optional) - Um Farben und Aussehen anzupassen, installieren Sie das Style Settings Plugin, indem Sie nach "Style Settings" in Community Plugins suchen

2 Erste Schritte

Hier ist die offizielle Anleitung zum Erlernen und Beherrschen von Notebook Navigator:

Mastering Notebook Navigator

Das Video ist mit Untertiteln in 21 Sprachen versehen.


3 Sicherheit und Qualität

Notebook Navigator wird mit TypeScript, ESLint mit dem offiziellen Obsidian ESLint-Plugin, Prettier, Vitest und einem Produktions-Build überprüft, bevor die Änderungen zusammengeführt werden. Der Build muss mit null Fehlern und null Warnungen abgeschlossen werden.

Sicherheitsprüfungen laufen über CodeQL, mit Scan-Historie in den CodeQL-Workflow-Läufen und der OpenSSF Scorecard. Der aktuelle Status wird in den Badges oben auf dieser Seite angezeigt.

Notebook Navigator wird lokal ausgeführt, aber einige Funktionen stellen dokumentierte HTTP-Anforderungen für Updates, Downloads und Remote-Inhalte. Eine vollständige Liste finden Sie in Abschnitt 10 - Offenlegung von Netzwerken und Diagnosen.


Inhaltsübersicht


4 Tastaturkurzbefehle

Schlüssel Aktion
↑/↓ Im aktuellen Bereich nach oben/unten navigieren
Im Navigationsbereich: Einblenden oder zum übergeordneten Bereich „ “ wechseln Im Listenbereich: Zum Navigationsbereich wechseln
Im Navigationsbereich: Erweitern oder zum Listenbereich wechseln Im Listenbereich: Zum Editor wechseln
Registerkarte Im Navigationsbereich: Zum Listenbereich wechseln Im Listenbereich: Zum Editor wechseln Im Suchfeld: Zum Listenbereich wechseln
Umschalt+Tab Im Listenbereich: Zum Navigationsbereich wechseln Im Suchfeld: Zum Navigationsbereich wechseln
Enter (macOS) F2 (Windows/Linux) Element im Navigations- oder Listenbereich direkt umbenennen
Enter Im Navigationsbereich: Ordnerhinweis unter Windows/Linux standardmäßig öffnen (sofern aktiviert) Im Listenbereich: Ausgewählte Datei auf allen Systemen öffnen (sofern aktiviert) Im Suchfeld: Zum Listenbereich wechseln
Esc Im Suchfeld: Suche schließen und Fokus auf den Listenbereich setzen
Bild auf/Bild ab Im Navigationsbereich und im Listenbereich nach oben/unten scrollen
Pos1/Ende Zum ersten/letzten Eintrag im aktuellen Bereich springen
Entf Backspace Ausgewähltes Element löschen
Cmd/Strg+A Alle Notizen im aktuellen Ordner auswählen
Cmd/Strg+Klick Notenauswahl umschalten
Umschalt+Klick Einen Notenbereich auswählen
Umschalt+Pos1/Ende Von der aktuellen Position bis zum ersten/letzten Element auswählen
Umschalt+↑/↓ Auswahl nach oben/unten erweitern
Cmd/Strg+↑/↓ Ausgewählte Dateien im manuellen Sortiermodus nach oben/unten verschieben

Hinweis: Alle Tastaturkürzel können angepasst werden. Siehe Abschnitt 7 - Benutzerdefinierte Tastenkombinationen für Details zum Hinzufügen von VIM-ähnlicher Navigation (h,j,k,l), alternativen Tasten und Modifizierungskombinationen.


5 Synchrone und lokale Einstellungen

Viele Einstellungen in Notebook Navigator zeigen einen Synchronisierungsschalter an - ein Wolkensymbol, das zwischen "Synchronisierung aktivieren" und "Synchronisierung deaktivieren" umschaltet. Damit wird gesteuert, wo die einzelnen Einstellungen gespeichert werden und ob sie für alle Geräte freigegeben sind.

5.1 Wie die Synchronisierung funktioniert

Obsidian-Plugins speichern ihre Konfiguration in data.json, das sich unter .obsidian/plugins/notebook-navigator/data.json in Ihrem Vault-Ordner befindet. Wenn Sie einen Synchronisierungsdienst verwenden - wie Obsidian Sync, iCloud, GitHub, Dropbox oder Google Drive - wird diese Datei zusammen mit dem Rest Ihres Tresors auf all Ihren Geräten synchronisiert. Jede auf data.json gespeicherte Einstellung wird auf jedes Gerät übertragen, das den Tresor synchronisiert.

Screenshot 2026-02-18 at 22 58 05

Wenn die Synchronisierung für eine Einstellung aktiviert ist (Standard), wird der Wert auf data.json gespeichert und über Ihren Synchronisierungsdienst mit allen Geräten synchronisiert.

Screenshot 2026-02-18 at 22 58 14

Wenn die Synchronisierung für eine Einstellung deaktiviert ist, wird der Wert stattdessen im lokalen Speicher von Obsidian gespeichert. Der lokale Speicher ist gerätespezifisch und wird nicht in die Tresor-Synchronisierung einbezogen. Die Einstellung hat auf jedem Gerät ihren eigenen unabhängigen Wert. Wenn Sie die Synchronisierung für eine Einstellung deaktivieren, wird der aktuelle Wert in den lokalen Speicher des aktuellen Geräts kopiert und der Wert wird von data.json entfernt, um zu verhindern, dass er lokale Werte auf anderen Geräten überschreibt.

Wenn Sie keinen Synchronisierungsdienst verwenden, hat die Umschaltfunktion für die Synchronisierung keine praktische Wirkung, da data.json nur lokal gespeichert wird.


6 Suche

Notebook Navigator verfügt über zwei Suchmodi: Filtersuche und Omnisuche. Wechseln Sie mit den Pfeiltasten nach oben/unten oder durch Klicken auf das Suchsymbol zwischen den beiden Modi. Kombinieren Sie Dateinamen, Eigenschaften, Tags, Daten und Filter in einer Abfrage (z. B. meeting .status=active #work @thisweek).

6.1 Suche filtern

Filtert Dateien nach Namen, Tags, Eigenschaften, Datum, Ordnern, Erweiterungen und Aufgaben innerhalb des aktuellen Ordners und der Unterordner. Standard-Suchmodus.

Dateinamen

  • word - Noten mit "Wort" im Dateinamen abgleichen
  • word1 word2 - Jedes Wort muss mit dem Dateinamen übereinstimmen
  • -word - Notizen mit "word" im Dateinamen ausschließen

Tags

  • #tag - Notizen mit Tag einschließen (passt auch zu verschachtelten Tags wie #tag/subtag)
  • # - Nur getaggte Notizen einbeziehen
  • -#tag - Notizen mit Tag ausschließen
  • -# - Nur unmarkierte Notizen einbeziehen
  • #tag1 #tag2 - Beide Tags abgleichen (implizites AND)
  • #tag1 AND #tag2 - Beide Tags abgleichen (explizites AND)
  • #tag1 OR #tag2 - Entspricht einem der beiden Tags
  • #a OR #b AND #c - AND hat einen höheren Vorrang: entspricht #a oder sowohl #b als auch #c
  • Cmd/Strg+Klicken Sie auf ein Tag, um es mit AND hinzuzufügen. Cmd/Strg+Umschalt+Klick zum Hinzufügen mit OR

Eigenschaften

  • .key - Notizen mit Eigenschaftsschlüssel einfügen
  • .key=value - Fügen Sie Notizen ein, wenn der Eigenschaftswert Folgendes enthält value
  • ."Reading Status" - Eigenschaftsschlüssel mit Leerzeichen (in doppelten Anführungszeichen)
  • ."Reading Status"="In Progress" - Schlüssel und Werte mit Leerzeichen müssen in Anführungszeichen gesetzt werden
  • -.key - Notizen mit Eigenschaftsschlüssel ausschließen
  • -.key=value - Notizen ausschließen, bei denen der Eigenschaftswert value
  • Cmd/Strg+Klick auf eine Eigenschaft zum Hinzufügen mit AND. Cmd/Strg+Umschalt+Klick zum Hinzufügen mit OR

Filter

  • has:task - Notizen mit unerledigten Aufgaben einfügen
  • -has:task - Ausschließen von Notizen mit unerledigten Aufgaben
  • folder:meetings - Notizen einfügen, wenn ein Ordnername Folgendes enthält meetings
  • folder:/work/meetings - Notizen nur in work/meetings aufnehmen (keine Unterordner)
  • folder:/ - Notizen nur in den Stamm des Tresors einfügen
  • -folder:archive - Notizen ausschließen, deren Ordnername archive
  • -folder:/archive - Notizen nur in archive ausschließen (nicht in Unterordnern)
  • ext:md - Einfügen von Notizen mit der Erweiterung md (ext:.md wird ebenfalls unterstützt)
  • -ext:pdf - Notizen mit Erweiterung ausschließen pdf
  • Kombinieren Sie mit Tags, Namen und Daten (z. B. folder:/work/meetings ext:md @thisweek)

Daten

  • @today - Abgleich von Notizen von heute mit dem Standard-Datumsfeld
  • @yesterday, @last7d, @last30d, @thisweek, @thismonth - Relative Datumsbereiche
  • @2026-02-07 - Einen einzelnen Tag abgleichen (unterstützt auch @20260207)
  • @2026 - Einem Kalenderjahr entsprechen
  • @2026-02 oder @202602 - Entspricht einem Kalendermonat
  • @2026-W05 oder @2026W05 - Anpassung an eine ISO-Woche
  • @2026-Q2 oder @2026Q2 - Entspricht einem Kalenderquartal
  • @13/02/2026 - Numerische Formate mit Trennzeichen (@07022026 folgt Ihrem Gebietsschema, wenn es mehrdeutig ist)
  • @2026-02-01..2026-02-07 - Passend zu einem umfassenden Tagesangebot (offene Enden werden unterstützt)
  • @c:... oder @m:... - Erstellungs- oder Änderungsdatum des Ziels
  • -@... - Eine Datumsübereinstimmung ausschließen

Das Standard-Datumsfeld folgt der aktuellen Sortierreihenfolge. Bei Sortierung nach Name wird das Datumsfeld unter Einstellungen → Notizen → Datum → Bei Sortierung nach Name konfiguriert.

AND/OR-Verhalten

AND und OR funktionieren in reinen Tag/Eigenschafts-Abfragen (Abfragen, die nur die Filter #tag, -#tag, #, -#, .key, -.key, .key=value oder -.key=value enthalten). Wenn die Abfrage auch Namen, Datumsangaben, Aufgabenfilter, Ordnerfilter oder Erweiterungsfilter enthält, werden AND und OR stattdessen als Dateinamenswörter abgeglichen.

  • Abfrage des Operators: #work OR .status=started
  • Gemischte Abfrage: #work OR ext:md (OR wird in Dateinamen abgeglichen)

6.2 Omnisearch

Volltextsuche im gesamten Tresor, gefiltert auf den aktuellen Ordner, Unterordner oder ausgewählte Tags. Erfordert das Omnisearch-Plugin. Wenn Omnisearch nicht installiert ist, fällt die Suche auf die Filtersuche zurück.

Die Notizvorschau zeigt Auszüge aus Omnisearch-Ergebnissen anstelle des Standardvorschautextes.

Bekannte Einschränkungen

  • Leistung - Kann bei der Suche nach weniger als 3 Zeichen in großen Tresoren langsam sein
  • Pfadfilter – Der Ordnerbereich wird nur bei einfachen ASCII-Pfaden an Omnisearch übermittelt. Andere Pfade werden gefiltert, nachdem Omnisearch die Ergebnisse zurückgegeben hat.
  • Begrenzte Ergebnisse - Omnisearch durchsucht den gesamten Tresor und gibt vor dem Filtern eine begrenzte Anzahl von Ergebnissen zurück, so dass relevante Dateien aus dem aktuellen Ordner möglicherweise nicht angezeigt werden, wenn es an anderer Stelle viele Treffer gibt
  • Vorschautext - Hinweisvorschauen werden durch Omnisearch-Ergebnisauszüge ersetzt, die möglicherweise nicht die eigentliche Suchtreffer-Markierung zeigen, wenn diese an anderer Stelle in der Datei erscheint

7 Benutzerdefinierte Hotkeys

Bearbeiten Sie .obsidian/plugins/notebook-navigator/data.json, um die Hotkeys des Notebook Navigators anzupassen. Öffnen Sie die Datei und suchen Sie den Abschnitt keyboardShortcuts. Jeder Eintrag ordnet eine Aktion einer oder mehreren Tastenkombinationen zu:

"pane:move-up": [ { "key": "ArrowUp", "modifiers": [] }, { "key": "K", "modifiers": [] } ]

Fügen Sie mehrere Bindungen pro Aktion hinzu, um alternative Tasten zu unterstützen, wie im obigen Beispiel ArrowUp und K. Kombinieren Sie Modifikatoren in einem Eintrag, indem Sie jeden Wert auflisten, zum Beispiel "modifiers": ["Mod", "Shift"]. Tastatursequenzen wie gg oder dd werden nicht unterstützt. Laden Sie Obsidian neu, nachdem Sie die Datei bearbeitet haben.

7.1 Modifikatoren

Modifikator Taste
Mod Cmd (macOS) / Strg (Win/Linux)
Alt Alt/Wahltaste
Shift Umschalttaste
Ctrl Steuerung (bevorzugt Mod für plattformübergreifend)

7.2 Verfügbare Aktionen

Aktion Standardtaste(n)
pane:move-up Pfeil nach oben
pane:move-down Pfeil nach unten
pane:page-up Bild auf
pane:page-down Bild-nach-unten
pane:home Start
pane:end Ende
pane:rename Enter (macOS), F2 (Windows/Linux)
pane:delete-selected Entf, Rücktaste
navigation:collapse-or-parent Pfeil nach links
navigation:expand-or-focus-list Pfeil nach rechts
navigation:focus-list Tab
list:focus-navigation Pfeil nach links, Umschalt+Tab
list:focus-editor Pfeil nach rechts, Tab
list:select-all Mod+A
list:extend-selection-up Umschalt+Pfeil nach oben
list:extend-selection-down Umschalt+Pfeil nach unten
list:manual-sort-up Mod+Pfeil nach oben
list:manual-sort-down Mod+Pfeil nach unten
list:range-to-start Umschalt+Pos1
list:range-to-end Umschalt+Ende
search:focus-list Tab, Enter
search:focus-navigation Umschalt+Tab
search:close Esc

8 Befehle

Legen Sie eigene Hotkeys für diese Befehle in den Hotkeys-Einstellungen von Obsidian fest:

Ansicht & Navigation

  • Notebook Navigator: Open Öffnet den Notebook-Navigator in der linken Seitenleiste. Falls bereits geöffnet, wird der Tastaturfokus in den Listenbereich verschoben. Anregung: Binden Sie an ein Tastenkürzel wie Cmd/Ctrl+Shift+E, um den Tastaturfokus in den Listenbereich zu verschieben - dies ist für eine vollständige Tastaturnavigation unerlässlich
  • Notebook Navigator: Toggle left sidebar Schaltet die linke Seitenleiste um. Setzt beim Öffnen die Ansicht der linken Seitenleiste auf Notebook-Navigator (im Gegensatz zu Obsidians eingebautem Befehl "Linke Seitenleiste umschalten", der die vorherige Ansicht der linken Seitenleiste wiederherstellt)
  • Notebook Navigator: Open homepage Öffnet die Ansicht Notebook Navigator und lädt das in den Einstellungen konfigurierte Homepage-Ziel
  • Notebook Navigator: Select vault profile Öffnet ein Modal zum Wechseln zwischen Tresorprofilen
  • Notebook Navigator: Reveal file Zeigt die aktuelle Datei im Navigator an. Erweitert übergeordnete Ordner und blättert zur Datei. Dieser Befehl ist nützlich, wenn Sie die Einstellung Auto-reveal active note ausgeschaltet haben und die Notizen manuell einblenden möchten. Anregung: Verknüpfen Sie ihn mit einem Tastenkürzel wie Cmd/Ctrl+Shift+R, um den ausgewählten Ordner oder die Markierung schnell in die aktuelle Datei zu ändern
  • Notebook Navigator: Open all files Öffnet alle Notizen im aktuell ausgewählten Ordner oder Tag. Wenn 15 oder mehr Dateien geöffnet werden, wird ein Bestätigungsdialog angezeigt
  • Notebook Navigator: Navigate to folder Suchdialog zum Springen in einen beliebigen Ordner
  • Notebook Navigator: Navigate to tag Suchdialog zum Springen zu einem beliebigen Tag
  • Notebook Navigator: Navigate to property Suchdialog, um zu einem beliebigen Eigenschaftsschlüssel oder -wert zu springen
  • Notebook Navigator: Navigate back Wechselt zur vorherigen Ordner-, Tag- oder Eigenschaftsauswahl im Navigationsverlauf
  • Notebook Navigator: Navigate forward Wechselt zur nächsten Ordner-, Tag- oder Eigenschaftsauswahl im Navigationsverlauf
  • Notebook Navigator: Add to shortcuts Fügt die aktuelle Datei, den aktuellen Ordner, das aktuelle Tag oder die aktuelle Eigenschaft zu den Verknüpfungen hinzu oder entfernt sie daraus
  • Notebook Navigator: Open shortcut 1-9 Öffnet die Verknüpfung anhand ihrer Position in der Liste der Verknüpfungen
  • Notebook Navigator: Search Öffnet das Feld für die Schnellsuche oder fokussiert es, wenn es bereits geöffnet ist. Die Suche bleibt zwischen den Sitzungen erhalten. Anregung: Bindung an ein Tastenkürzel wie Cmd/Ctrl+Shift+S für schnelle Dateifilterung
  • Notebook Navigator: Search whole vault Wählt den Stammordner des Tresors aus und startet die Suche unter Einbeziehung der Unterordner ( Show root folder muss aktiviert sein)

Auswahl

  • Notebook Navigator: Select next file Verschiebt die Auswahl zur nächsten Datei im aktuellen Ordner oder in der Tag-Ansicht. Berücksichtigt die benutzerdefinierte Sortierreihenfolge. Anregung: Bindung an ein Tastenkürzel wie Option+Cmd+Right, um schnell zur nächsten Datei in der Liste zu gelangen
  • Notebook Navigator: Select previous file Verschiebt die Auswahl zur vorherigen Datei in der aktuellen Ordner- oder Tag-Ansicht. Berücksichtigt die benutzerdefinierte Sortierreihenfolge. Anregung: Bindung an ein Tastenkürzel wie Option+Cmd+Left, um schnell zur vorherigen Datei in der Liste zu gelangen

Layout & Anzeige

  • Notebook Navigator: Toggle dual pane layout Umschalten zwischen ein- und zweigeteiltem Layout (Desktop). Anregung: Bindung an eine Tastenkombination wie Cmd/Ctrl+Shift+A, um schnell zwischen ein- und zweigeteiltem Layout zu wechseln
  • Notebook Navigator: Toggle dual pane orientation Umschalten der Ausrichtung des Doppelfensters zwischen horizontal und vertikal
  • Notebook Navigator: Toggle descendants Umschalten der Anzeige von Unterordnern/Nachfolgernotizen bei Ordnern und Tags. Anregung: Bindung an ein Tastenkürzel wie Cmd/Ctrl+Shift+D, um die Anzeige von Notizen aus Unterordnern / Nachfolgern schnell umzuschalten
  • Notebook Navigator: Toggle hidden folders, tags, and notes Versteckte Ordner, Tags und Notizen anzeigen oder ausblenden
  • Notebook Navigator: Toggle tag sort order Zwischen alphabetischer und frequenzbasierter Sortierung der Tags umschalten
  • Notebook Navigator: Toggle tags by selection Umschalten zwischen der Beschränkung von Tags auf diejenigen, die in Notizen innerhalb des ausgewählten Ordners oder der ausgewählten Eigenschaft gefunden wurden
  • Notebook Navigator: Toggle properties by selection Eigenschaften auf die in den Notizen des ausgewählten Ordners oder Tags gefundenen beschränken
  • Notebook Navigator: Toggle compact mode Umschalten des Listenmodus zwischen Standard und Kompakt
  • Notebook Navigator: Toggle pinned section Angeheftete Notizen im Listenbereich anzeigen oder ausblenden
  • Notebook Navigator: Collapse / expand all items Klappt alle Elemente je nach aktuellem Status ein oder aus. Wenn Keep selected item expanded aktiviert ist (Standardeinstellung), werden alle Ordner mit Ausnahme des aktuellen Ordners zugeklappt. Dies ist praktisch, um den Navigationsbaum bei der Suche nach Dokumenten aufgeräumt zu halten
  • Notebook Navigator: Collapse / expand selected item Das ausgewählte Navigationselement ein- oder ausklappen

Kalender

  • Notebook Navigator: Toggle calendar Schaltet den Kalender ein oder aus. Anregung: Binden Sie an ein Tastenkürzel wie Cmd/Ctrl+Shift+C, um den Kalender schnell anzuzeigen
  • Notebook Navigator: Open daily note Öffnet die tägliche Notiz für den heutigen Tag basierend auf den Kalendereinstellungen. Erstellt die Notiz, wenn sie nicht existiert
  • Notebook Navigator: Open weekly note Öffnet die aktuelle Wochennotiz. Erstellt die Notiz, wenn sie nicht existiert
  • Notebook Navigator: Open monthly note Öffnet die aktuelle Monatsnotiz. Erstellt die Notiz, wenn sie nicht existiert
  • Notebook Navigator: Open quarterly note Öffnet die aktuelle vierteljährliche Notiz. Erstellt die Notiz, wenn sie nicht existiert
  • Notebook Navigator: Open yearly note Öffnet die aktuelle Jahresnotiz. Erstellt die Notiz, wenn sie nicht existiert

Dateioperationen

Wichtig! Obsidian hat keinen Kontext "aktueller Ordner oder Tag", so dass beim Erstellen von Notizen in Obsidian diese standardmäßig im Stammordner, im gleichen Ordner wie die aktuelle Datei oder in einem bestimmten Ordner erstellt werden. Wenn Sie mit dem Notebook Navigator arbeiten, möchten Sie neue Notizen immer im aktuell ausgewählten Ordner oder Tag erstellen. Daher sollten Sie als erstes Cmd/Ctrl+N an Notebook Navigator: Create new note binden, damit neue Notizen immer im aktuell ausgewählten Ordner oder Tag erstellt werden. Das Gleiche gilt auch für das Verschieben und Löschen von Dateien. Aus diesem Grund sollten Sie diese Befehle anstelle der eingebauten Obsidian-Befehle verwenden, wenn Sie den Notebook Navigator benutzen.

  • Notebook Navigator: Create new note Notiz im aktuell ausgewählten Ordner erstellen. Anregung: Binden Sie Cmd/Ctrl+N an diesen Befehl (lösen Sie zuerst die Bindung von Obsidians Standardbefehl "Neue Notiz erstellen")
  • Notebook Navigator: Create new note from template Notiz aus Vorlage im aktuell ausgewählten Ordner erstellen (erfordert Templater)
  • Notebook Navigator: Move files Verschiebt ausgewählte Dateien in einen anderen Ordner. Wählt die nächste Datei im aktuellen Ordner aus
  • Notebook Navigator: Merge notes Eine Notiz aus ausgewählten Markdown-Notizen in der aktuellen Listenreihenfolge erstellen
  • Notebook Navigator: Convert to folder note Erstellen Sie einen Ordner, der dem Dateinamen entspricht, und verschieben Sie die Datei dorthin als Ordnerhinweis
  • Notebook Navigator: Set as folder note Umbenennen der aktiven Datei in den Namen der Ordnernotiz
  • Notebook Navigator: Detach folder note Trennen Sie die Ordnernotiz im ausgewählten Ordner und benennen Sie sie um
  • Notebook Navigator: Pin all folder notes Alle Ordnernotizen in allen Ordnern anheften. Der Befehl ist nur sichtbar, wenn Ordnernotizen aktiviert sind.
  • Notebook Navigator: Delete files Ausgewählte Dateien löschen. Wählt die nächste Datei im aktuellen Ordner

Tag-Operationen

  • Notebook Navigator: Add tag to selected files Dialog zum Hinzufügen von Tags zu ausgewählten Dateien. Unterstützt die Erstellung neuer Tags
  • Notebook Navigator: Set property on selected files Dialog zum Festlegen von Eigenschaften für ausgewählte Dateien
  • Notebook Navigator: Remove tag from selected files Dialog zum Entfernen eines bestimmten Tags. Entfernt sofort, wenn nur ein Tag
  • Notebook Navigator: Remove all tags from selected files Löschen aller Tags aus ausgewählten Dateien mit Bestätigung

Wartung

  • Notebook Navigator: Rebuild cache Stellt den lokalen Notebook Navigator-Cache wieder her. Verwenden Sie diese Funktion, wenn Sie fehlende Tags, falsche Vorschauen oder fehlende Feature-Bilder feststellen

8.1 Befehls-IDs

Befehls-ID Befehlsname
notebook-navigator:open Notebook-Navigator: Öffnen
notebook-navigator:toggle-left-sidebar Notebook-Navigator: Linke Seitenleiste ein-/ausblenden
notebook-navigator:open-homepage Notebook-Navigator: Startseite öffnen
notebook-navigator:select-profile Notebook-Navigator: Tresorprofil auswählen
notebook-navigator:select-profile-1 Notebook-Navigator: Tresorprofil 1 auswählen
notebook-navigator:select-profile-2 Notebook-Navigator: Tresorprofil 2 auswählen
notebook-navigator:select-profile-3 Notebook Navigator: Tresorprofil 3 auswählen
notebook-navigator:reveal-file Notebook Navigator: Datei anzeigen
notebook-navigator:open-all-files Notebook-Navigator: Alle Dateien öffnen
notebook-navigator:navigate-to-folder Notebook Navigator: Zum Ordner navigieren
notebook-navigator:navigate-to-tag Notebook Navigator: Zu Tag navigieren
notebook-navigator:navigate-to-property Notebook-Navigator: Zur Eigenschaft navigieren
notebook-navigator:navigate-back Notebook-Navigator: Zurück navigieren
notebook-navigator:navigate-forward Notebook-Navigator: Weiter navigieren
notebook-navigator:add-shortcut Notebook-Navigator: Zu den Verknüpfungen hinzufügen
notebook-navigator:open-shortcut-1 Notebook-Navigator: Verknüpfung 1 öffnen
notebook-navigator:open-shortcut-2 Notebook-Navigator: Verknüpfung 2 öffnen
notebook-navigator:open-shortcut-3 Notebook-Navigator: Verknüpfung 3 öffnen
notebook-navigator:open-shortcut-4 Notebook-Navigator: Verknüpfung 4 öffnen
notebook-navigator:open-shortcut-5 Notebook Navigator: Verknüpfung 5 öffnen
notebook-navigator:open-shortcut-6 Notebook Navigator: Verknüpfung 6 öffnen
notebook-navigator:open-shortcut-7 Notebook-Navigator: Verknüpfung 7 öffnen
notebook-navigator:open-shortcut-8 Notebook Navigator: Verknüpfung 8 öffnen
notebook-navigator:open-shortcut-9 Notebook-Navigator: Verknüpfung 9 öffnen
notebook-navigator:search Notebook-Navigator: Suchen
notebook-navigator:search-vault Notebook-Navigator: Gesamten Tresor durchsuchen
notebook-navigator:toggle-dual-pane Notebook-Navigator: Zwischen Zwei-Fenster-Layout umschalten
notebook-navigator:toggle-dual-pane-orientation Notebook-Navigator: Ausrichtung des zweigeteilten Fensters umschalten
notebook-navigator:toggle-calendar Notebook-Navigator: Kalender umschalten
notebook-navigator:open-daily-note Notebook-Navigator: Tagesnotiz öffnen
notebook-navigator:open-weekly-note Notebook-Navigator: Wochennotiz öffnen
notebook-navigator:open-monthly-note Notebook-Navigator: Monatliche Notiz öffnen
notebook-navigator:open-quarterly-note Notebook-Navigator: Quartalsnotiz öffnen
notebook-navigator:open-yearly-note Notebook-Navigator: Jahresnotiz öffnen
notebook-navigator:toggle-descendants Notebook Navigator: Unterordner ein-/ausblenden
notebook-navigator:toggle-hidden Notebook-Navigator: Ausgeblendete Ordner, Tags und Notizen ein- und ausblenden
notebook-navigator:toggle-tag-sort Notebook-Navigator: Sortierreihenfolge der Tags umschalten
notebook-navigator:toggle-tags-by-selection Notebook-Navigator: Tags nach Auswahl ein-/ausblenden
notebook-navigator:toggle-properties-by-selection Notebook-Navigator: Eigenschaften nach Auswahl ein- und ausblenden
notebook-navigator:toggle-compact-mode Notebook-Navigator: Kompaktmodus ein- und ausschalten
notebook-navigator:toggle-pinned-section Notebook-Navigator: Angehefteten Bereich ein- und ausblenden
notebook-navigator:collapse-expand Notebook-Navigator: Alle Elemente ausblenden/einblenden
notebook-navigator:collapse-expand-selected-item Notebook-Navigator: Ausgewähltes Element ein- bzw. ausblenden
notebook-navigator:new-note Notebook-Navigator: Neue Notiz erstellen
notebook-navigator:new-note-from-template Notebook-Navigator: Neue Notiz aus Vorlage erstellen
notebook-navigator:move-files Notebook-Navigator: Dateien verschieben
notebook-navigator:merge-notes Notebook-Navigator: Notizen zusammenführen
notebook-navigator:select-next-file Notebook-Navigator: Nächste Datei auswählen
notebook-navigator:select-previous-file Notebook-Navigator: Vorherige Datei auswählen
notebook-navigator:convert-to-folder-note Notebook Navigator: In Ordner-Notiz umwandeln
notebook-navigator:set-as-folder-note Notebook-Navigator: Als Ordner-Notiz festlegen
notebook-navigator:detach-folder-note Notizbuch-Navigator: Ordner-Notiz lösen
notebook-navigator:pin-all-folder-notes Notebook-Navigator: Alle Ordner-Notizen anheften
notebook-navigator:delete-files Notebook-Navigator: Dateien löschen
notebook-navigator:add-tag Notebook Navigator: Ausgewählten Dateien Tag hinzufügen
notebook-navigator:set-property Notebook Navigator: Eigenschaft für ausgewählte Dateien festlegen
notebook-navigator:remove-tag Notebook Navigator: Tag von ausgewählten Dateien entfernen
notebook-navigator:remove-all-tags Notebook Navigator: Alle Tags von ausgewählten Dateien entfernen
notebook-navigator:rebuild-cache Notebook Navigator: Cache neu aufbauen

9 Merkmale

9.1 Schnittstelle

  • Zweigeteiltes Layout - Navigationsbereich (Ordner/Tags/Eigenschaften) und Listenbereich (Dateien)
  • Einseitiger Modus - Navigations- und Listenansichten mit animierten Übergängen
  • Veränderbare Fenster - Horizontale oder vertikale Teilung
  • Unabhängiger UI-Zoom - Skalieren des Notebook-Navigators ohne Änderung des Obsidian-Zooms
  • Startansicht - Navigation zuerst oder Liste zuerst
  • Mehrsprachige Unterstützung - 21 Sprachen mit RTL-Layout-Unterstützung
  • Schnittstellensymbolsatz - Anpassbare UI-Symbole für das gesamte Plugin

9.2 Navigation

  • Tresorprofile - Mehrere gefilterte Ansichten mit pro Profil versteckten Ordnern/Tags/Notizen, Dateisichtbarkeit, Bannern und Verknüpfungen
  • Schnellzugriffe – Notizen, Ordner, Tags, Eigenschaften und gespeicherte Suchanfragen mit Anheften und Neuanordnung
  • Letzte Notizen/Dateien - Abschnitt "Letzte Objekte" pro Tresorprofil gespeichert, optional mit Verknüpfungen angeheftet
  • Kalender - Kalender für tägliche Notizen mit Tagesauswahl, Bildvorschau und Unterstützung für vertikale Aufteilung
  • Ordnerbaum - Auf- und Zuklappen der Navigation mit manueller Anordnung der Stammordner
  • Tag-Baum - Hierarchische Tags mit konfigurierbarer Anordnung der Stamm-Tags
  • Eigenschaftsbrowser - Durchsuchen von Dateieigenschaften, geordnet nach Schlüssel und Wert, mit Dateizählung, benutzerdefinierten Farben, Symbolen und Drag-and-Drop
  • Automatisches Anzeigen der aktiven Datei - Ordnererweiterung und Scrollen zur Auswahl
  • Tastatur und Befehle - Konfigurierbare Hotkeys, Befehle für die Auswahlhistorie vor/zurück, Befehle für die nächste/vorherige Datei, Befehle für das Öffnen der Tastenkombinationen 1-9

9.3 Organisation

  • Anheften von Notizen - Halten Sie wichtige Notizen am Anfang von Ordnern und Tags fest
  • Ordnernotizen - Festlegen/Lösen von Ordnernotizen, Anheften von Ordnernotizen, Option "In neuer Registerkarte öffnen
  • Tag-Operationen - Hinzufügen/Entfernen/Löschen von Tags, Umbenennen/Löschen von Tags, Erstellen einer Notiz im Tag, Ziehen und Ablegen der Tag-Hierarchie
  • Benutzerdefinierte Sortierung und Gruppierung - Überschreiben der Sortier-/Gruppierungseinstellungen pro Ordner oder Tag
  • Erscheinungen pro Ordner/Tag - Titelzeilen, Vorschaureihen, Kompaktmodus, Umschalten zwischen Nachkommenschaft
  • Versteckte Inhalte - Versteckte Ordner/Tags/Notizen/Dateien mit Mustern, Frontmatter-Eigenschaften und tagbasierter Filterung pro Tresorprofil
  • Ordner aus Unterordnern ausschließen – Ordner beim Erfassen von Notizen aus Unterordnern gemäß dem Tresorprofil auslassen; ausgeschlossene Ordner bleiben sichtbar und zeigen ihre Notizen an, wenn sie ausgewählt werden
  • Farb- und Symbolsystem - Ordner-/Tag-/Eigenschafts-/Dateifarben, Symbolpakete, Emoji-/Lucide-Symbole, Frontmatter lesen/schreiben, Symbolzuordnung nach Dateinamen und Dateitypkategorie
  • Namenswarnungen - Warnung vor verbotenen Dateisystemzeichen und Zeichen, die Obsidian-Verknüpfungen bei der Benennung von Dateien und Ordnern aufheben

9.4 Dateianzeige

  • Notizvorschau - 1-5 Vorschauzeilen mit optionalem HTML-Stripping
  • Miniaturansichten – Ausgewählte Bilder sowie automatisch generierte Miniaturansichten für PDF-, SVG- und Zeichnungsdateien, die im Metadaten-Cache gespeichert sind
  • Externe Bilder - Optionale Downloads für externe Bilder und YouTube-Miniaturansichten
  • Datumsgruppierung - Gruppieren Sie Notizen nach Heute, Gestern, Vorherige 7 Tage, Vorherige 30 Tage, Monate und Jahre, wenn Sie nach Datum sortieren
  • Frontmatter-Unterstützung - Lesen von Notennamen und Zeitstempeln aus Frontmatter-Feldern
  • Metadaten notieren - Änderungsdatum und Tags in der Dateiliste anzeigen
  • Benutzerdefinierte Eigenschaften - Anzeige von Frontmatter-Eigenschaften oder Wortanzahl in der Dateiliste mit Überschreibungen pro Ordner/Tag und benutzerdefinierten Farben
  • Anzeige des übergeordneten Ordners - Optionaler Name und Symbol des übergeordneten Ordners in der Dateiliste
  • Kompaktmodus - Kompakte Anzeige, wenn Vorschau, Datum und Bilder deaktiviert sind
  • Anklickbare Tags - Tags in der Dateiliste navigieren direkt zu diesem Tag

9.5 Produktivität

  • Suche - Filtern nach Dateinamen, Tags, Eigenschaften, Daten, Ordnern, Erweiterungen und Aufgaben mit AND/OR/Ausschlüssen
  • Omnisearch-Integration - Volltextsuche über Omnisearch
  • Ziehen und Ablegen - Verschieben von Dateien, Markieren, Zuweisen von Verknüpfungen, Reparieren des Tag-Baums, Ordner mit Sprungfunktion
  • Kontextmenüs - Erstellen von Notizen/Ordnern/Layouts/Grundlagen/Zeichnungen und Ausführen von Datei-/Tag-Aktionen
  • Zeichnungen - Erstellen von Excalidraw- und Tldraw-Zeichnungen aus den Menüs des Navigations- und Listenbereichs
  • Templates - Neue Notiz von Template-Befehlen mit dem Templater-Plugin
  • Dateioperationen - Erstellen, Umbenennen, Duplizieren, Verschieben, Löschen von Dateien und Ordnern
  • Filterung - Ausschlüsse von Ordnern/Tags/Notizen/Dateien mit Mustern und Frontmatter-Eigenschaften

10 Offenlegung von Netzwerken und Diagnosen

Notebook Navigator läuft lokal, aber einige Funktionen stellen HTTP-Anfragen von Obsidian aus. Die Debug-Protokollierung beim Start kann auch eine lokale Diagnosedatei in Ihren Tresor schreiben.

10.1 Prüfungen zur Freigabe der Aktualisierung (fakultativ)

  • Einstellung: "Beim Start auf neue Version prüfen"
  • Anfrage: https://api.github.com/repos/johansan/notebook-navigator/releases/latest
  • Häufigkeit: Höchstens einmal pro 24 Stunden, beim Starten
  • Daten: Sendet Standard-HTTP-Metadaten; enthält keine Tresorinhalte

10.2 Icon Pack Downloads (Optional)

  • Einstellung: Aktivieren Sie ein Icon Pack auf der Registerkarte Icon Packs
  • Anfragen: https://raw.githubusercontent.com/johansan/notebook-navigator/main/icon-assets/... (Manifest, Schriftart, Metadaten)
  • Speicherung: Lokal in IndexedDB gespeichert

10.3 Externe Bilder, Videos und YouTube-Miniaturansichten

  • Feature-Bilder (Optional): Gesteuert durch die Einstellung "Externe Bilder herunterladen". Lädt externe Bilder und YouTube-Thumbnails für Feature-Bilder herunter und speichert sie lokal in IndexedDB.
  • Willkommensmodal (Erster Start): Lädt ein statisches Vorschaubild von https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/youtube-thumbnail.jpg.
  • Neues Modal (bei Aktualisierung / beim Öffnen): Lädt Versionsbanner-Bilder von https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.jpg für Versionshinweise, die ein Banner enthalten.
  • Modal „Was gibt’s Neues?“ (Bei Aktualisierung / beim Öffnen): Lädt Release-Videos von https://raw.githubusercontent.com/johansan/notebook-navigator/main/images/version-banners/<id>.mp4 für Release-Hinweise, die ein Video enthalten.
  • Modal „Was gibt’s Neues?“ (beim Öffnen eines Veröffentlichungsvideos): Öffnet Veröffentlichungsvideos von https://cdn.jsdelivr.net/gh/johansan/notebook-navigator@main/images/version-banners/<id>.mp4, sodass Browser das Video direkt abspielen können.
  • Neues Modal (bei Aktualisierung / beim Öffnen): Lädt YouTube-Miniaturansichten von https://img.youtube.com/vi/<id>/... für Versionshinweise, die einen YouTube-Link enthalten.

10.4 Debug-Dateien für den Start (optional)

  • Einstellung: "Debug-Protokollierung beim Start"
  • Speicherung: Schreibt eine mit einem Zeitstempel versehene Datei nn-debug-...md in das Stammverzeichnis des Tresors und hält dann an, nachdem der Startvorgang abgeschlossen ist. Die Datei kann synchronisiert werden, wenn das Stammverzeichnis des Tresors synchronisiert ist.
  • Daten: Enthält Startzeitpunkt, Plugin-Version, minimal unterstützte Obsidian-Version, Plattform, Cache-Anzahl, Warteschlangen-Anzahl, IndexedDB-Status und Diagnosefehler. Es enthält keine Notizinhalte, Tag-Namen, Frontmatter-Werte oder eine Liste von Tresordateien.
  • Pfade und Bezeichner: Startup-Initialisierung, PDF-Diagnosen und Fehlerfälle können die Obsidian-Anwendungs-/Vault-Kennung, Vault-relative PDF-Pfade oder Fehler-Stack-Details enthalten. Überprüfen und redigieren Sie die Datei, bevor Sie sie öffentlich freigeben.
  • Hochladen: Notebook Navigator lädt keine Debug-Dateien hoch. Sie werden nur freigegeben, wenn Sie sie außerhalb des Plug-ins hochladen, anhängen oder synchronisieren.

10.5 Datenschutz und Datenverarbeitung

  • Notebook Navigator sendet keine Notizinhalte, Dateinamen, Tags oder Debug-Dateien an einen Notebook Navigator-Server.
  • Anfragen an GitHub, YouTube und externe Bildhosts werden direkt von Ihrem Gerät aus gestellt und enthalten standardmäßige HTTP-Metadaten (IP-Adresse, User-Agent und Ähnliches).
  • Heruntergeladene Icon Packs und Bilder werden lokal gespeichert (IndexedDB). Aktuelle Notizen/Dateien und der Zustand der Benutzeroberfläche werden lokal gespeichert (Obsidian Local Storage).

11 Sterne Geschichte

Star History Chart


12 Kontakt

Notebook Navigator wird von Johan Sanneblad entwickelt und gepflegt. Johan Sanneblad hat einen Doktortitel in Softwareentwicklung und hat mit Innovationsentwicklung für Unternehmen wie Apple, Electronic Arts, Google, Microsoft, Lego, SKF, Volvo Cars, Volvo Group und Yamaha gearbeitet.

Sie können sich gerne mit mir auf LinkedIn verbinden.


13 Fragen oder Probleme?

Treten Sie unserem Discord für Support und Diskussionen, oder öffnen Sie einen Eintrag imGitHub-Repository.

Pull-Anfragen werden nicht akzeptiert. Seit dem Aufkommen des „Agentic Coding“ können externe Code-Beiträge nicht mehr gemäß den Qualitätsstandards des Projekts geprüft werden, weshalb alle Pull-Anfragen automatisch geschlossen werden. Reichen Sie Ihre Ideen stattdessen als Feature-Anfragen ein – eröffnen Sie dazu ein Issue. Weitere Informationen finden Sie in der Datei CONTRIBUTING.md.


14 Lizenz

Dieses Projekt steht unter der GNU General Public License v3.0 - siehe die LICENSE-Datei für Details.