什么是Obsidian via notesmd-cli (obsidian-cli)
Obsidian via notesmd-cli（简称 obsidian-cli）是一个专为 Obsidian 笔记库设计的命令行工具，它通过直接操作磁盘上的纯 Markdown 文件来实现对 Obsidian 库的自动化管理。与依赖图形界面或必须启动 Obsidian 桌面应用的方式不同，该工具可在 Obsidian 未运行的情况下，直接在终端中完成笔记的创建、编辑、搜索和重构等操作，极大提升了开发者和高级用户在脚本化工作流中的效率。其核心理念是将 Obsidian 库视为一个普通的本地文件夹，利用标准的文件系统接口进行读写，同时智能地处理 Obsidian 特有的元数据与内部链接结构。 该工具通过读取 macOS 系统上 `~/Library/Application Support/obsidian/obsidian.json` 这一关键配置文件，自动识别当前处于‘打开’状态的 Vault（即笔记库），并解析出 Vault 的名称和实际路径。这使得用户无需手动指定路径，即可快速定位到正在使用的笔记库。对于日常使用，用户可以设置一个默认 Vault，并通过简单的命令获取其路径，实现‘一键定位’笔记根目录。此外，工具完全兼容 Obsidian 的标准 Vault 结构，包括存放 `.md` 文件的笔记区、包含插件与工作区设置的 `.obsidian/` 配置目录、存储 `.canvas` 文件的画布区域，以及用户自定义的附件文件夹。这种设计确保了与现有 Obsidian 生态的无缝集成。
核心功能特点
- 自动识别并切换 Obsidian Vault：通过读取系统配置文件，智能定位当前激活的笔记库，并支持设置默认 Vault。
- 强大的笔记操作能力：支持创建、删除、重命名和移动笔记，并能安全地更新笔记间的内部链接（如 [[wikilink]]），避免因简单文件移动导致的链接断裂。
- 灵活的搜索功能：提供交互式模糊搜索和全文内容搜索，帮助用户快速定位所需信息，搜索结果会显示相关片段和行号。
- 高效的日常笔记管理：可自动创建或打开当天的日报笔记（Daily Note），并完全遵循 `.obsidian/daily-notes.json` 中的模板和路径配置。
- 精细的元数据控制：支持读取、修改和删除笔记文件顶部的 YAML Frontmatter 元数据，便于构建任务管理系统或知识图谱。
- 无侵入式编辑：允许用户直接通过 `$EDITOR` 在外部编辑器中修改 `.md` 文件，Obsidian 会自动同步变更，适合习惯命令行工作流的用户。
适用场景
Obsidian-cli 特别适合那些希望将 Obsidian 深度集成到自动化脚本或复杂个人知识管理流程中的高级用户。例如，开发者可以编写 Shell 脚本，利用 `notesmd-cli create` 和 `frontmatter` 命令自动生成带有特定标签和状态的项目日志，再结合其他工具进行后续处理。对于从事写作或研究的人员，可以通过 `search-content` 命令在海量笔记中进行精准的内容检索，并直接跳转到目标文件，极大地提高了信息提取的效率。其核心的‘安全重命名’功能在处理大量相互引用的笔记时尤为宝贵，能够自动修复所有相关的内部链接，避免了手动维护链接的繁琐与遗漏，是进行大规模笔记重构的理想选择。 在日常办公场景中，该工具也能显著提升生产力。用户可以在终端中快速创建新的会议记录或任务清单，并通过设置好的模板和元数据字段，实现信息的结构化录入。对于喜欢使用 Vim、Emacs 或其他专业文本编辑器进行高效写作的用户，`–editor` 参数让他们可以在自己最熟悉的工具中编辑笔记，而无需每次都切换到 Obsidian 的图形界面，编辑完成后保存，Obsidian 便会自动识别更改。此外，结合 `daily` 命令，用户可以轻松建立一套基于日报的追踪体系，每日的思考与产出都能被系统地归档和索引，形成一份不断演进的个人数字资产库。