obsidian

Was macht obsidian?

Verwende die offizielle obsidian-CLI für die Arbeit mit Obsidian-Vaults. Vault-Dateien sind reines Markdown, daher sind direkte Dateibearbeitungen weiterhin in Ordnung, wenn sie sicherer/schneller sind.

Voraussetzungen

• Obsidian 1.12.7+ installiert.
• Einstellungen -> Allgemein -> Befehlszeilenschnittstelle aktiviert.
• obsidian im PATH registriert.
• Obsidian-App läuft; die CLI verbindet sich mit der laufenden App.

Prüfen:

obsidian version
obsidian help

Die macOS-Registrierung erstellt /usr/local/bin/obsidian, das auf die im App-Bundle enthaltene CLI zeigt. Die Linux-Registrierung kopiert die Binärdatei nach ~/.local/bin/obsidian.

Vault-Modell

• Notizen: *.md.
• Konfiguration: .obsidian/; Bearbeitung vermeiden, wenn nicht explizit angefragt.
• Canvases: *.canvas JSON.
• Anhänge: vault-konfigurierter Ordner.
• Mehrere Vaults sind üblich; bei Mehrdeutigkeit vault="<Name>" übergeben.

Obsidian Desktop zeichnet Vaults hier auf:

• ~/Library/Application Support/obsidian/obsidian.json

Befehlsmuster

obsidian <Befehl> [name=wert] [flag]
obsidian vault="Notizen" search query="Meeting-Notizen" format=json

Parameterwerte mit Leerzeichen benötigen Anführungszeichen. Füge --copy hinzu, um die Ausgabe zu kopieren, wo sinnvoll.

Häufige Befehle

Öffnen/Lesen:

obsidian open file=Rezept
obsidian open path="Inbox/Idee.md" newtab
obsidian read
obsidian read file=Rezept

Suchen:

obsidian search query="TODO" matches
obsidian search query="status::active" format=json
obsidian search:open query="Projektnotizen"

Erstellen/Ändern:

obsidian create name="Neue Notiz"
obsidian create path="Inbox/Idee.md" content="# Idee"
obsidian append file=Notiz content="Neue Zeile"
obsidian prepend file=Notiz content="Nach Frontmatter"

Verschieben/Löschen:

obsidian move file=Notiz to=Archiv/
obsidian move path="Inbox/Alt.md" to="Projekte/Neu.md"
obsidian delete file=Notiz

Täglich/Aufgaben:

obsidian daily
obsidian daily:read
obsidian daily:append content="- [ ] Posteingang prüfen"
obsidian tasks all todo
obsidian task file=Notiz line=8 done

Eigenschaften/Links:

obsidian tags all counts
obsidian property:read file=Notiz name=status
obsidian property:set file=Notiz name=status wert=erledigt
obsidian backlinks file=Notiz
obsidian unresolved verbose counts

Entwickler/Debug:

obsidian plugin:reload mein-plugin
obsidian dev:errors
obsidian dev:screenshot file=bild.png
obsidian eval "app.vault.getFiles().length"

Hinweise

• file=<Name> verwendet die Obsidian-interne Dateiauflösung; path=<vault-relativer.md> ist exakt.
• Bevorzuge CLI-Befehle für Verschieben/Löschen/Eigenschaften, um Obsidian-konforme Aktualisierungen sicherzustellen.
• Bevorzuge direkte Markdown-Bearbeitungen für Massentextänderungen, nachdem der Vault-Pfad lokalisiert wurde.
• Verlasse dich nicht auf Drittanbieter-obsidian-cli, es sei denn, der Nutzer fragt explizit danach.