SuperAPI AI 工具集

obsidian

办公与效率

查看项目

更新于 10-16 06:56

技能介绍

Obsidian

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

仓库结构(典型)

  • 笔记:*.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 会自动识别。