核心用法
Obsidian 技能通过 notesmd-cli 将 Obsidian 知识库（纯 Markdown 文件夹）转化为可编程对象，实现跨平台自动化操作。核心能力包括：
- Vault 管理：自动读取 Obsidian 官方配置定位本地仓库，支持多 Vault 切换与默认 Vault 设置
- 笔记生命周期：创建/读取/移动/删除笔记，支持 frontmatter 操作与内容追加/覆盖
- 智能搜索：文件名模糊搜索 + 全文内容搜索（含上下文片段）
- 链接维护：移动笔记时自动更新
[[wikilinks]]，避免断链 - 每日日记：快速打开或追加当天日记，支持自定义模板路径
显著优点
- 零侵入：直接操作纯文本 Markdown，不依赖 Obsidian 运行时，数据完全本地可控
- 自动化友好：命令行接口适合脚本集成（如定时任务、CI/CD 文档同步）
- 跨平台：支持 macOS/Linux，通过标准日期命令处理跨系统差异
潜在局限
- 功能边界：创建笔记需 Obsidian URI handler（必须安装 Obsidian），无法纯 CLI 完成全部流程
- 平台限制：Windows 支持未明确，日期命令差异需手动处理
- 配置依赖：依赖 Obsidian 桌面版的
obsidian.json定位仓库，移动版/新安装可能无此文件
适合人群
- 重度 Obsidian 用户寻求自动化工作流
- 开发者/技术写作者需将笔记系统与脚本工具链集成
- 需要批量处理 Markdown、迁移笔记结构的数据整理者
常规风险
- 数据覆盖：
--overwrite和--append操作不可逆，建议配合版本控制（Git）使用 - 链接损坏：虽工具会更新 wikilinks，但外部引用（如其他工具生成的链接）可能失效
- 路径注入：避免在笔记路径中使用用户输入的未转义字符串，防止意外文件操作