---

name: obsidian description: 操作 Obsidian 知识库（纯 Markdown 笔记）并通过 obsidian-cli 实现自动化。 homepage: https://help.obsidian.md metadata: {"clawdbot":{"emoji":"💎","requires":{"bins":["obsidian-cli"]},"install":[{"id":"brew","kind":"brew","formula":"yakitrak/yakitrak/obsidian-cli","bins":["obsidian-cli"],"label":"安装 obsidian-cli (brew)"}]}}

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 快速入门

选择一个默认的 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 会检测到变化。