技能介绍

为什么需要命令行管理 Obsidian

Obsidian 把本地 Markdown 文件夹变成了强大的知识库，但当我们需要批量处理笔记、编写自动化脚本，或者在 CI/CD 流程中管理内容时，依赖鼠标点击的 GUI 界面就显得力不从心。直接使用 mv 或 rm 命令操作文件虽然快捷，却会导致仓库内大量的 [[wikilinks]] 和 Markdown 链接瞬间失效，后续修复成本极高。我们需要一种既能直接操作磁盘，又能保持 Obsidian 语义完整性的工具。

核心能力与工作方式

notesmd-cli 直接在文件系统层面与 Vault 交互，无需启动 Obsidian 应用即可完成大部分操作。

仓库定位与初始化：通过读取 macOS 系统下的 ~/Library/Application Support/obsidian/obsidian.json，自动解析当前活跃的 Vault 路径，并支持一键设置默认仓库和打开方式。
内容搜索与创建：提供交互式模糊搜索（search）和内容级全文检索（search-content）。创建笔记时，可直接通过 create 命令指定路径和初始内容，甚至自动套用 Obsidian 的新建文件默认配置。
安全重构与元数据：当需要移动或重命名笔记时，move 命令不仅更新文件路径，还会智能扫描并更新整个 Vault 内的 [[wikilinks]] 和标准 Markdown 链接。此外，它还支持对 YAML frontmatter 进行增删改查，以及根据 daily-notes.json 配置自动生成每日笔记。

适用边界与注意点

虽然该工具极大地提升了自动化能力，但在使用时仍需注意边界。它主要依赖 Obsidian 桌面版生成的配置文件来解析仓库状态，因此在纯服务器或无头环境中使用时，需确保默认 Vault 已正确配置。同时，除非必要，建议避免通过脚本直接修改 .obsidian/ 目录下的核心配置文件，以免破坏工作区设置。对于简单的文本修改，直接在编辑器中打开 .md 文件往往比调用 CLI 更直观。