\r \r

Obsidian\r

\r Obsidian vault = a normal folder on disk.\r \r Vault structure (typical)\r

• Notes: *.md (plain text Markdown; edit with any editor)\r
• Config: .obsidian/ (workspace + plugin settings; usually don’t touch from scripts)\r
• Canvases: *.canvas (JSON)\r
• Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.)\r \r

Find the active vault(s)\r

\r Obsidian desktop tracks vaults here (source of truth):\r

• ~/Library/Application Support/obsidian/obsidian.json\r \r notesmd-cli resolves vaults from that file; vault name is typically the folder name (path suffix).\r \r Fast “what vault is active / where are the notes?”\r
• If you’ve already set a default: notesmd-cli print-default --path-only\r
• Otherwise, read ~/Library/Application Support/obsidian/obsidian.json and use the vault entry with "open": true.\r \r

notesmd-cli quick start\r

\r Pick a default vault and open behavior (once):\r

• notesmd-cli set-default "\x3Cvault-folder-name>"\r
• notesmd-cli set-default --open-type editor (Sets default to use your terminal/GUI $EDITOR instead of opening the Obsidian app)\r
• notesmd-cli print-default / notesmd-cli print-default --path-only\r \r Search\r
• notesmd-cli search (Interactive fuzzy search for notes; respects Obsidian's excluded files)\r
• notesmd-cli search-content "query" (Searches inside notes; shows snippets + lines)\r \r Create\r
• notesmd-cli create "Folder/New note" --content "..."\r
• notesmd-cli create "New note" --open (Opens in Obsidian, or $EDITOR if --editor flag is passed)\r
• Note: Works directly on disk (headless supported); Obsidian does not need to be running. Reads .obsidian/app.json for default new file locations.\r \r Daily Notes\r
• notesmd-cli daily (Creates or opens today's daily note directly on disk)\r
• Automatically reads your .obsidian/daily-notes.json for folder, format, and template configurations.\r \r Frontmatter (YAML Metadata)\r
• notesmd-cli frontmatter "NoteName" --print\r
• notesmd-cli frontmatter "NoteName" --edit --key "status" --value "done"\r
• notesmd-cli frontmatter "NoteName" --delete --key "draft"\r \r Move/rename (safe refactor)\r
• notesmd-cli move "old/path/note" "new/path/note"\r
• Updates [[wikilinks]] and common Markdown links across the vault (this is the main win vs standard mv).\r \r Delete\r
• notesmd-cli delete "path/note"\r \r Prefer direct edits when appropriate: open the .md file in any editor (notesmd-cli open "note" --editor) and change it; Obsidian will automatically pick it up.