Obsidian

Obsidian 仓库（vault）= 磁盘上的一个普通文件夹。

仓库结构（典型）

• 笔记： *.md（纯文本 Markdown；可用任意编辑器编辑）
• 配置： .obsidian/（工作区 + 插件设置；脚本中通常不应直接修改）
• 画布： *.canvas（JSON 格式）
• 附件：你在 Obsidian 设置中指定的任意文件夹（如图片、PDF 等）

查找当前激活的仓库（vault）

Obsidian 桌面端在此处维护仓库列表（权威来源）：

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

obsidian-cli 从该文件解析仓库信息；仓库名称通常为文件夹名（即路径末尾部分）。

快速确认：“当前激活的是哪个仓库？笔记存放在哪里？”

• 若已设置默认仓库：obsidian-cli print-default --path-only
• 否则，读取 ~/Library/Application Support/obsidian/obsidian.json，并选取其中 "open": true 的条目。

注意事项

• 多仓库场景很常见（例如 iCloud 与 ~/Documents、工作与个人等），切勿猜测，应以配置为准。
• 避免在脚本中硬编码仓库路径；推荐通过读取配置或调用 print-default 动态获取。

obsidian-cli 快速入门

设置默认仓库（仅需一次）：

• obsidian-cli set-default ""
• obsidian-cli print-default / obsidian-cli print-default --path-only

搜索

• obsidian-cli search "query"（匹配笔记标题）
• obsidian-cli search-content "query"（全文搜索；返回匹配片段及所在行）

创建

• obsidian-cli create "Folder/New note" --content "..." --open
• 需确保 Obsidian URI 处理器（obsidian://…）已就绪（即 Obsidian 已安装并注册协议）。
• 避免通过 URI 在“隐藏”点文件夹（例如 .something/...）下创建笔记；Obsidian 可能拒绝该操作。

移动／重命名（安全重构）

• obsidian-cli move "old/path/note" "new/path/note"
• 自动更新整个仓库内的 [[wikilinks]] 及常见 Markdown 链接（这是相比系统 mv 命令的核心优势）。

删除

• obsidian-cli delete "path/note"

在合适场景下，优先采用直接编辑方式：打开对应 .md 文件进行修改，Obsidian 将自动识别变更。