Obsidian

Obsidian vault = a normal folder on disk.

Vault structure (typical)

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

Obsidian desktop tracks vaults here (source of truth):

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

notesmd-cli

resolves vaults from that file; vault name is typically the folder name (path suffix).

Fast “what vault is active / where are the notes?”

Otherwise, read

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

and use the vault entry with

"open": true

Pick a default vault and open behavior (once):

notesmd-cli set-default "<vault-folder-name>"

notesmd-cli print-default

notesmd-cli print-default --path-only

```
notesmd-cli search
```
(Interactive fuzzy search for notes; respects Obsidian's excluded files)
```
notesmd-cli search-content "query"
```
(Searches inside notes; shows snippets + lines)

Create

notesmd-cli create "Folder/New note" --content "..."

notesmd-cli create "New note" --open

(Opens in Obsidian, or

$EDITOR

--editor

flag is passed)

Note: Works directly on disk (headless supported); Obsidian does not need to be running. Reads
```
.obsidian/app.json
```
for default new file locations.

Daily Notes

```
notesmd-cli daily
```
(Creates or opens today's daily note directly on disk)
Automatically reads your
```
.obsidian/daily-notes.json
```
for folder, format, and template configurations.

Frontmatter (YAML Metadata)

notesmd-cli frontmatter "NoteName" --print

notesmd-cli frontmatter "NoteName" --edit --key "status" --value "done"

notesmd-cli frontmatter "NoteName" --delete --key "draft"

Move/rename (safe refactor)

notesmd-cli move "old/path/note" "new/path/note"

Delete

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.

Obsidian via notesmd-cli (obsidian-cli)