用途:在 Obsidian 运行时,通过官方 CLI 对 vault 内的笔记与文件夹执行文件级操作,包括读取、创建、追加/前置、移动、重命名、删除、列表、日记笔记与随机笔记。
前提:需安装 Obsidian 桌面版 v1.12.4+,在设置→通用中启用命令行界面,且 Obsidian 必须处于运行状态(CLI 与运行实例通信)。
路径与参数约定:路径均为 vault 相对路径,如 folder/note.md;file=<名称> 按 wikilink 方式解析(无需扩展名),path=<完整路径.md> 为精确路径;未提供 file= 或 path= 时多数命令默认作用于当前活动文件;create 的 name= 省略 .md(自动添加),move 的 to= 需带 .md;含空格的值需加引号;换行用 \n,制表符用 \t;标志为裸词,如 overwrite、open、newtab、permanent、inline、total,唯一例外是 --copy。多 vault 时在命令前加 vault=<名称>。
主要能力:obsidian files 列出文件(可按 folder=、ext= 过滤,total 仅计数);obsidian folders 列出文件夹(format=tree 树状);obsidian file / folder 查看信息;obsidian wordcount 统计字数;obsidian read 读取笔记(--copy 复制到剪贴板);obsidian create 创建(可带 content=、template=、overwrite、open);obsidian append / prepend 追加或前置(inline 不额外换行,prepend 跳过 YAML);obsidian open 打开(newtab、paneType=tab|split|window);obsidian move / rename 移动或重命名(启用自动更新内部链接时会同步更新链接);obsidian delete 删除(permanent 跳过回收站且不可逆);obsidian daily 及 daily:path、daily:read、daily:append、daily:prepend 处理日记;obsidian random、random:read 随机笔记;obsidian unique 创建唯一笔记;obsidian web 在内置网页查看器打开 URL;obsidian version、reload、restart 维护应用。输出格式支持 format=json、csv、tsv、tree。
适用场景:在 Obsidian 运行期间管理笔记文件、文件夹布局、日记记录与快速捕获,适合需要结构化输出(如 JSON)供程序或智能体解析的场合。
限制:CLI 依赖运行中的 Obsidian 实例;daily 命令不提供 date= 参数,查看历史日记需用 open path= 指定实际路径;离线批量编辑多个 .md 文件应改用 vault-frontmatter 或 vault-templates;整理 MOC 用 vault-mocs;重命名并重写全部链接用 vault-wikilinks;恢复历史版本用 file-history;查询 Base 视图用 bases。相关技能还包括 search-discovery、properties、tasks、templates、vault-management。