obsidian

用途

Obsidian vault 就是磁盘上一个普通文件夹，笔记以纯 Markdown 纯文本（*.md）保存，因此可以用任何编辑器直接编辑。本技能面向通过与 obsidian-cli 命令行工具配合，对 vault 内容进行查找、创建、移动、删除等自动化操作。

Vault 结构（典型）

• 笔记：*.md（纯文本 Markdown，可用任意编辑器编辑）
• 配置：.obsidian/（工作区与插件设置；脚本通常不要改动）
• 画布：*.canvas（JSON）
• 附件：由 Obsidian 设置中选定的文件夹决定（图片、PDF 等）

查找当前活动的 vault

Obsidian 桌面端在此处记录 vault 列表（作为事实来源）：

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

obsidian-cli 会从该文件解析 vault；vault 名称通常即文件夹名称（路径后缀）。

快速判断“当前活动的是哪个 vault／笔记在哪里”：

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

注意事项：

• 存在多个 vault 很常见（例如 iCloud 与 ~/Documents、工作与个人等）。不要猜测，请读取配置。
• 避免在脚本中写死 vault 路径；应优先读取配置或使用 print-default。

obsidian-cli 快速上手

选取默认 vault（只需一次）：

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

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"

该操作会在整个 vault 中更新 [[wikilinks]] 以及常见的 Markdown 链接（这是相比 mv 的主要优势）。

删除：

obsidian-cli delete "path/note"

适当时优先直接编辑：打开 .md 文件并修改，Obsidian 会自动同步到该变更。

适用场景与限制

适用于以纯 Markdown 笔记为基础、需要脚本化或命令行管理知识库的场景，包括批量搜索、创建、安全重命名（自动更新链接）与删除。限制方面：创建笔记依赖 Obsidian 已安装且 URI 处理器可用；vault 路径不应硬编码，应通过配置文件或 print-default 获取；.obsidian/ 配置目录不建议由脚本改动；资料未说明跨平台细节、价格或更多集成能力，暂未提供。