命令行驱动你的第二大脑

通过 obsidian-cli 管理 Obsidian 知识库，实现笔记搜索、创建、安全重命名及链接自动更新，适合自动化 PKM 工作流。

基本信息

• 技能名称?Obsidian 1.0.0
• 中文名称?命令行驱动你的第二大脑
• 作者?terryren2024
• 分类?专业技能
• 版本?1.0.0
• 标签?pkm, markdown, note-taking, cli, automation, knowledge-management, obsidian

使用方法

使用说明
核心用法
Obsidian 本质是一个本地 Markdown 笔记管理工具，每个 vault 即普通文件夹。 obsidian-cli 提供命令行接口，支持：
vault 定位 ：读取 ~/Library/Application Support/obsidian/obsidian.json 获取活动 vault，避免硬编码路径
搜索 ： search （文件名）与 search-content （全文检索带上下文）
笔记管理 ： create （支持 --open 直接唤起 Obsidian）、 move / rename （自动修复 vault 内所有 [[wikilink]] 和 Markdown 链接）、 delete
直接编辑 ： .md 文件即纯文本，可用任意编辑器修改，Obsidian 实时同步
显著优点

1. 链接安全重构 ： move 命令的核心价值——自动更新双向链接，避免手动断链
2. 零锁定 ：vault 是标准文件夹，笔记为纯 Markdown，随时迁移至其他工具
3. URI 集成 ：通过 obsidian:// 协议与桌面端联动，兼顾脚本自动化与 GUI 体验
4. 多 vault 支持 ：适合工作/个人、iCloud/本地分离等场景
   潜在局限
   依赖 Obsidian 安装 ： create --open 需 URI handler，纯 headless 环境受限
   URI 限制 ：无法通过协议创建隐藏目录（ . 开头）下的笔记
   canvas 文件 ： *.canvas 为 JSON 格式，需专门处理，cli 不直接支持
   插件配置 ： .obsidian/ 目录存储复杂插件状态，自动化修改易引发兼容问题
   适合人群
   已使用 Obsidian 的开发者/高级用户，希望将笔记工作流接入 shell 脚本
   需要批量重构笔记结构、维护大型知识库的 PKM 重度用户
   偏好本地优先、文件系统透明的 Markdown 管理方案者
   常规风险
   move 操作虽自动更新链接，但大规模重构前仍建议 git 备份 vault
   多设备同步时（iCloud/Dropbox），cli 操作可能与 Obsidian 移动端产生冲突，需确保同步完成后再执行命令
   delete 无回收站机制，直接永久删除