obsidian

Obsidian

Obsidian 知识库 = 磁盘上的普通文件夹。

知识库结构（典型）

• 笔记：*.md（纯文本 Markdown；可用任何编辑器编辑）
• 配置：.obsidian/（工作区 + 插件设置；通常不要通过脚本修改）
• 画布：*.canvas（JSON）
• 附件：你在 Obsidian 设置中选择的任意文件夹（图片/PDF 等）

查找当前使用的知识库

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 "<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"
• 会更新整个知识库中的 [[wikilinks]] 和常见 Markdown 链接（这是相较于 mv 的主要优势）。

删除

• obsidian-cli delete "path/note"

适当时优先直接编辑：打开 .md 文件并修改；Obsidian 会自动识别。