name: obsidian description: 使用Obsidian库（纯Markdown笔记）并通过obsidian-cli自动化。 homepage: https://help.obsidian.md metadata: { “otto”: { “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 vs
~/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会拾取。