Index der Dokumentation
Hauptdokumentation
- README (dieses Dokument)
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
- Obsidian installieren - Herunterladen und installieren von obsidian.md
- Aktivieren Sie Community-Plugins - Gehen Sie zu Einstellungen → Community-Plugins → Aktivieren Sie Community-Plugins
- Notebook Navigator installieren - Klicken Sie auf "Durchsuchen" → Suchen Sie nach "Notebook Navigator" → Installieren
- 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:
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
- 5 Synchrone und lokale Einstellungen
- 6 Suche
- 7 Benutzerdefinierte Hotkeys
- 8 Befehle
- 9 Merkmale
- 10 Offenlegung von Netzwerken und Diagnosen
- 11 Sterne Geschichte
- 12 Kontakt
- 13 Fragen oder Probleme?
- 14 Lizenz
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.
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.
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 abgleichenword1 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#aoder sowohl#bals 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ältvalue."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 Eigenschaftswertvalue- 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 Aufgabenfolder:meetings- Notizen einfügen, wenn ein Ordnername Folgendes enthältmeetingsfolder:/work/meetings- Notizen nur inwork/meetingsaufnehmen (keine Unterordner)folder:/- Notizen nur in den Stamm des Tresors einfügen-folder:archive- Notizen ausschließen, deren Ordnernamearchive-folder:/archive- Notizen nur inarchiveausschließen (nicht in Unterordnern)ext:md- Einfügen von Notizen mit der Erweiterungmd(ext:.mdwird ebenfalls unterstützt)-ext:pdf- Notizen mit Erweiterung ausschließenpdf- 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-02oder@202602- Entspricht einem Kalendermonat@2026-W05oder@2026W05- Anpassung an eine ISO-Woche@2026-Q2oder@2026Q2- Entspricht einem Kalenderquartal@13/02/2026- Numerische Formate mit Trennzeichen (@07022026folgt 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(ORwird 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 wieCmd/Ctrl+Shift+E, um den Tastaturfokus in den Listenbereich zu verschieben - dies ist für eine vollständige Tastaturnavigation unerlässlichNotebook Navigator: Toggle left sidebarSchaltet 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-ZielNotebook Navigator: Select vault profileÖffnet ein Modal zum Wechseln zwischen TresorprofilenNotebook Navigator: Reveal fileZeigt die aktuelle Datei im Navigator an. Erweitert übergeordnete Ordner und blättert zur Datei. Dieser Befehl ist nützlich, wenn Sie die EinstellungAuto-reveal active noteausgeschaltet haben und die Notizen manuell einblenden möchten. Anregung: Verknüpfen Sie ihn mit einem Tastenkürzel wieCmd/Ctrl+Shift+R, um den ausgewählten Ordner oder die Markierung schnell in die aktuelle Datei zu ändernNotebook 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 angezeigtNotebook Navigator: Navigate to folderSuchdialog zum Springen in einen beliebigen OrdnerNotebook Navigator: Navigate to tagSuchdialog zum Springen zu einem beliebigen TagNotebook Navigator: Navigate to propertySuchdialog, um zu einem beliebigen Eigenschaftsschlüssel oder -wert zu springenNotebook Navigator: Navigate backWechselt zur vorherigen Ordner-, Tag- oder Eigenschaftsauswahl im NavigationsverlaufNotebook Navigator: Navigate forwardWechselt zur nächsten Ordner-, Tag- oder Eigenschaftsauswahl im NavigationsverlaufNotebook Navigator: Add to shortcutsFügt die aktuelle Datei, den aktuellen Ordner, das aktuelle Tag oder die aktuelle Eigenschaft zu den Verknüpfungen hinzu oder entfernt sie darausNotebook Navigator: Open shortcut 1-9Öffnet die Verknüpfung anhand ihrer Position in der Liste der VerknüpfungenNotebook 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 wieCmd/Ctrl+Shift+Sfür schnelle DateifilterungNotebook Navigator: Search whole vaultWählt den Stammordner des Tresors aus und startet die Suche unter Einbeziehung der Unterordner (Show root foldermuss aktiviert sein)
Auswahl
Notebook Navigator: Select next fileVerschiebt 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 wieOption+Cmd+Right, um schnell zur nächsten Datei in der Liste zu gelangenNotebook Navigator: Select previous fileVerschiebt die Auswahl zur vorherigen Datei in der aktuellen Ordner- oder Tag-Ansicht. Berücksichtigt die benutzerdefinierte Sortierreihenfolge. Anregung: Bindung an ein Tastenkürzel wieOption+Cmd+Left, um schnell zur vorherigen Datei in der Liste zu gelangen
Layout & Anzeige
Notebook Navigator: Toggle dual pane layoutUmschalten zwischen ein- und zweigeteiltem Layout (Desktop). Anregung: Bindung an eine Tastenkombination wieCmd/Ctrl+Shift+A, um schnell zwischen ein- und zweigeteiltem Layout zu wechselnNotebook Navigator: Toggle dual pane orientationUmschalten der Ausrichtung des Doppelfensters zwischen horizontal und vertikalNotebook Navigator: Toggle descendantsUmschalten der Anzeige von Unterordnern/Nachfolgernotizen bei Ordnern und Tags. Anregung: Bindung an ein Tastenkürzel wieCmd/Ctrl+Shift+D, um die Anzeige von Notizen aus Unterordnern / Nachfolgern schnell umzuschaltenNotebook Navigator: Toggle hidden folders, tags, and notesVersteckte Ordner, Tags und Notizen anzeigen oder ausblendenNotebook Navigator: Toggle tag sort orderZwischen alphabetischer und frequenzbasierter Sortierung der Tags umschaltenNotebook Navigator: Toggle tags by selectionUmschalten zwischen der Beschränkung von Tags auf diejenigen, die in Notizen innerhalb des ausgewählten Ordners oder der ausgewählten Eigenschaft gefunden wurdenNotebook Navigator: Toggle properties by selectionEigenschaften auf die in den Notizen des ausgewählten Ordners oder Tags gefundenen beschränkenNotebook Navigator: Toggle compact modeUmschalten des Listenmodus zwischen Standard und KompaktNotebook Navigator: Toggle pinned sectionAngeheftete Notizen im Listenbereich anzeigen oder ausblendenNotebook Navigator: Collapse / expand all itemsKlappt alle Elemente je nach aktuellem Status ein oder aus. WennKeep selected item expandedaktiviert 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 haltenNotebook Navigator: Collapse / expand selected itemDas ausgewählte Navigationselement ein- oder ausklappen
Kalender
Notebook Navigator: Toggle calendarSchaltet den Kalender ein oder aus. Anregung: Binden Sie an ein Tastenkürzel wieCmd/Ctrl+Shift+C, um den Kalender schnell anzuzeigenNotebook Navigator: Open daily noteÖffnet die tägliche Notiz für den heutigen Tag basierend auf den Kalendereinstellungen. Erstellt die Notiz, wenn sie nicht existiertNotebook Navigator: Open weekly noteÖffnet die aktuelle Wochennotiz. Erstellt die Notiz, wenn sie nicht existiertNotebook Navigator: Open monthly noteÖffnet die aktuelle Monatsnotiz. Erstellt die Notiz, wenn sie nicht existiertNotebook Navigator: Open quarterly noteÖffnet die aktuelle vierteljährliche Notiz. Erstellt die Notiz, wenn sie nicht existiertNotebook 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 noteNotiz im aktuell ausgewählten Ordner erstellen. Anregung: Binden SieCmd/Ctrl+Nan diesen Befehl (lösen Sie zuerst die Bindung von Obsidians Standardbefehl "Neue Notiz erstellen")Notebook Navigator: Create new note from templateNotiz aus Vorlage im aktuell ausgewählten Ordner erstellen (erfordert Templater)Notebook Navigator: Move filesVerschiebt ausgewählte Dateien in einen anderen Ordner. Wählt die nächste Datei im aktuellen Ordner ausNotebook Navigator: Merge notesEine Notiz aus ausgewählten Markdown-Notizen in der aktuellen Listenreihenfolge erstellenNotebook Navigator: Convert to folder noteErstellen Sie einen Ordner, der dem Dateinamen entspricht, und verschieben Sie die Datei dorthin als OrdnerhinweisNotebook Navigator: Set as folder noteUmbenennen der aktiven Datei in den Namen der OrdnernotizNotebook Navigator: Detach folder noteTrennen Sie die Ordnernotiz im ausgewählten Ordner und benennen Sie sie umNotebook Navigator: Pin all folder notesAlle Ordnernotizen in allen Ordnern anheften. Der Befehl ist nur sichtbar, wenn Ordnernotizen aktiviert sind.Notebook Navigator: Delete filesAusgewählte Dateien löschen. Wählt die nächste Datei im aktuellen Ordner
Tag-Operationen
Notebook Navigator: Add tag to selected filesDialog zum Hinzufügen von Tags zu ausgewählten Dateien. Unterstützt die Erstellung neuer TagsNotebook Navigator: Set property on selected filesDialog zum Festlegen von Eigenschaften für ausgewählte DateienNotebook Navigator: Remove tag from selected filesDialog zum Entfernen eines bestimmten Tags. Entfernt sofort, wenn nur ein TagNotebook Navigator: Remove all tags from selected filesLöschen aller Tags aus ausgewählten Dateien mit Bestätigung
Wartung
Notebook Navigator: Rebuild cacheStellt 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>.jpgfü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>.mp4fü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-...mdin 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
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.