核心用法
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无回收站机制，直接永久删除