Obsidian 官方命令行工具

在Obsidian里做批量笔记重命名、自动化同步检查或插件调试时，逐个点击GUI按钮不仅低效，也难以纳入脚本或CI流程。开发者想在终端复现问题、截取界面截图或快速重载插件，更需要脱离鼠标操作。

核心能力与工作方式

• 文件操作：支持通过file=参数按Wikilink名称解析文件，或用path=指定库根目录下的精确路径，可执行创建、移动、重命名、删除等操作，多行内容用`

和 转义，--copy`可将输出复制到剪贴板。

• 搜索与内容管理：内置文本搜索、标签与属性筛选，能快速定位笔记；可统计链接结构、生成每日笔记或管理任务清单，也能调用模板插入内容或操作书签。
• 同步与历史：集成Obsidian Sync命令，支持文件历史查看与恢复，方便追踪笔记的变更轨迹。
• 插件与主题：可通过命令行安装、启用、禁用插件，切换主题或修改CSS样式，开发者能用--reload参数快速重载插件，结合截图命令捕获界面状态。
• TUI模式：提供交互式终端界面，支持光标导航、内容编辑、历史回溯等快捷键，比如用↑/↓浏览历史命令，Ctrl+R反向搜索，适合需要反复操作的场景。

适用边界与注意点

• 需满足Obsidian 1.12+版本且拥有Catalyst license，需在「设置→通用→命令行接口」中启用，注册obsidian命令后重启终端（macOS需执行source ~/.zprofile）。
• Obsidian必须处于运行状态，CLI才能正常工作；Windows平台需要通过Obsidian.com提供的终端重定向器（需加入Catalyst Discord获取），Linux平台需确保/usr/local/bin/obsidian软链接存在。
• 参数值含空格时需用引号包裹，多行内容需用`

`转义，避免因格式错误导致命令执行失败。