核心用法
Obsidian 官方 CLI 是 Obsidian 1.12+ 内置的命令行工具，通过 IPC 与运行中的 Obsidian 实例通信。支持 115 个命令，覆盖笔记管理的完整生命周期：
文件与内容管理：create/read/append/prepend/move/delete 实现程序化笔记操作，支持模板插入和属性读写。
知识网络分析：backlinks/links/orphans/deadends/unresolved 提供双向链接拓扑分析，辅助发现知识孤岛和断链。
任务与标签系统：tasks 筛选待办，tags counts 统计标签分布，property:set 程序化修改 YAML 属性。
搜索与导航：search:context 带上下文搜索，daily 系列快速操作日记，random 随机阅读。
高级功能：eval 执行 JavaScript 直接操作 Obsidian API，dev:screenshot 自动化截图，sync/publish 管理云端同步与发布。
显著优点
- 官方原生：由 Obsidian 团队维护，与编辑器行为完全一致，无第三方解析差异
- 功能完备：115 个命令覆盖 99% 的日常操作场景，从基础文件到数据库查询
- 脚本友好：
--copy输出剪贴板，\n支持换行，便于与 Alfred、Raycast、AutoHotkey 集成 - 跨平台：原生支持 macOS/Windows/Linux，包含 Snap/Flatpak/AppImage 适配
局限与约束
- 必须运行 GUI：依赖 Obsidian 进程存活，无法纯后台/服务器部署
- 单实例限制：IPC 通信限制，多开 Obsidian 时行为未定义
- 无远程能力：仅限本地 vault，不支持 SSH/远程文件系统直接操作
- 模板依赖：
template:insert需配合官方模板插件，社区模板方案不兼容
适合人群
- 重度键盘用户，追求「不离开终端」的效率极客
- 需要批量操作笔记的开发者/研究员
- 构建个人知识管理自动化工作流的高级用户
- 与 Obsidian Publish/Sync 配合的内容运营者
常规风险
- 数据安全：
delete/move等操作不可逆，建议配合obsidian sync版本历史 - API 稳定性：
eval执行 JavaScript 直接操作内部 API，跨版本可能失效 - 并发问题：CLI 与 GUI 同时修改同一文件可能产生冲突
- 路径注入：
path=参数接受任意文件系统路径，需警惕路径遍历风险