用途:通过终端 obsidian 命令控制 Obsidian 库,完成各类可从命令行执行的 Obsidian 任务。
前提条件:需 Obsidian 1.12.4+ 并在设置(Settings > General > CLI)中启用 CLI;Obsidian 桌面应用必须处于运行状态,首条命令会在需要时启动它。
命令语法:obsidian [vault=<name>] <command> [params] [flags]。参数为 key=value,含空格的值需加引号,如 content="Hello world";flag 为布尔开关,如 open、overwrite、total。指定库时把 vault=<name> 放在命令前,或先 cd 到库目录;指定文件用 file=<name>(wikilink/模糊匹配)或 path=<path>(从库根开始的精确路径)。多行用 \n 表示换行、\t 表示制表符;任意命令追加 --copy 可把输出复制到系统剪贴板。
主要能力:创建与编辑笔记(create、read、append、prepend,支持 template);日记(daily、daily:read、daily:append、daily:path);搜索(search、search:context,可用 format=json、total);属性与标签(property:set、property:read、tags、tag);任务(tasks todo、tasks daily、task done/toggle);链接与图谱分析(backlinks、links、orphans、deadends、unresolved);插件(plugins、plugin:install、plugin:reload);文件与文件夹(files、folders、move、delete)。完整命令文档见 references/commands.md,命令类别涵盖 General、Files/Folders、Daily Notes、Search、Properties、Tags、Links、Tasks、Templates、Outline、Bookmarks、Bases、Plugins、Themes/Snippets、Sync、Publish、Vault、Workspaces/Tabs、Unique Notes、Word Count、Web Viewer、Random Notes、File History、Developer。
使用方式示例:obsidian create name="Meeting Notes" content="# Meeting\n\n- Topic:" open;obsidian daily:append content="- Did X";obsidian search query="meeting" limit=10;obsidian task file=Recipe line=8 done。
限制与注意:命令必须使用 obsidian,不要用 obs 等别名;桌面应用未运行则命令无法工作;format=json 便于程序化解析输出;total 只返回数量而非列表。其他未在资料中说明的细节暂未提供。