Obsidian Task
Manage tasks in your Obsidian vault using the official Obsidian CLI.
Dependencies
| Dependency | Required | Description |
|---|
| INLINECODE0 | Yes | Obsidian CLI (registered via Obsidian settings) |
| INLINECODE1 |
Yes | Catalyst license required for CLI access |
Check Dependencies
CODEBLOCK0
Prerequisites
- - Obsidian 1.12+ and Catalyst license required
- Settings → General → Command line interface → Enable
- Follow prompt to register the
obsidian command - Restart terminal or
source ~/.zprofile (macOS) - Note: Obsidian must be running for CLI to work
Test setup: INLINECODE4
Usage
CODEBLOCK1
Commands
| Command | Description |
|---|
| (none) | Show help and available commands |
Options
| Option | Description |
|---|
| INLINECODE5 | Show help message |
Examples
CODEBLOCK2
Raw CLI Commands
CODEBLOCK3
```
Obsidian Task
使用官方 Obsidian CLI 管理 Obsidian 仓库中的任务。
依赖项
| 依赖项 | 必需 | 描述 |
|---|
| obsidian | 是 | Obsidian CLI（通过 Obsidian 设置注册） |
| Obsidian 1.12+ |
是 | 需要 Catalyst 许可证才能使用 CLI |
检查依赖项
bash
检查 obsidian CLI 是否可用
obsidian version
前置条件
- - 需要 Obsidian 1.12+ 和 Catalyst 许可证
- 设置 → 常规 → 命令行界面 → 启用
- 按照提示注册 obsidian 命令
- 重启终端或执行 source ~/.zprofile（macOS）
- 注意： CLI 运行时 Obsidian 必须处于运行状态
测试设置：obsidian version
用法
bash
/obsidian-task [命令] [选项]
命令
选项
示例
bash
列出任务
/obsidian-task tasks file=projects/myproject/todo verbose
切换第 2 行的任务状态
/obsidian-task task file=projects/myproject/todo line=2 toggle
将任务标记为已完成
/obsidian-task task file=projects/myproject/todo line=2 done
将任务标记为待办（撤销完成状态）
/obsidian-task task file=projects/myproject/todo line=2 todo
创建新任务
/obsidian-task append file=projects/myproject/todo content=- [ ] 任务名称
原始 CLI 命令
bash
列出任务（显示行号和状态）
obsidian tasks file=
/todo verbose
示例输出：
projects//TODO.md
2 - [ ] 未完成的任务
3 - [x] 已完成的任务
更新任务
obsidian task file=/todo line=2 toggle
obsidian task file=/todo line=2 done
obsidian task file=/todo line=2 todo
创建新任务（通过追加）
obsidian append file=/todo content=- [ ] 任务名称
