obsidian-tasks
使用Obsidian Tasks插件进行任务管理。在创建、编辑、查询或管理Obsidian保险库中的任务时使用。涵盖Dataview内联字段格式(主要)、查询语法、过滤器、排序、分组、重复规则、优先级和自定义状态。触发条件:任务查询、待办事项管理、任务过滤、重复任务、任务仪表板或涉及带元数据的`- [ ]`复选框项的任何工作。
name: obsidian-tasks
description: "Work with the Obsidian Tasks plugin for task management. Use when creating, editing, querying, or managing tasks in an Obsidian vault. Covers Dataview inline field format (primary), query syntax, filters, sorting, grouping, recurrence rules, priorities, and custom statuses. Trigger on: task queries, todo management, task filtering, recurring tasks, task dashboards, or any work involving - [ ] checkbox items with metadata."
Obsidian Tasks Plugin
The Tasks plugin enables task management across an Obsidian vault. Tasks are standard Markdown checkboxes with optional metadata for dates, priority, recurrence, and status.
Task Format Overview
This vault uses Dataview format (inline fields with [key:: value] syntax), not emoji format.
Basic Task Structure
- [ ] Task description [due:: 2024-01-15] [priority:: high]
- [x] Completed task [done:: 2024-01-10]
- [/] In progress task
- [-] Cancelled task
Available Fields (Dataview Format)
| Field | Syntax | Purpose |
|---|---|---|
| Due date | [due:: YYYY-MM-DD] |
When task must be completed |
| Scheduled date | [scheduled:: YYYY-MM-DD] |
When to work on task |
| Start date | [start:: YYYY-MM-DD] |
When task becomes available |
| Created date | [created:: YYYY-MM-DD] |
When task was created |
| Done date | [done:: YYYY-MM-DD] |
Auto-added on completion |
| Priority | [priority:: highest/high/medium/low/lowest] |
Task importance |
| Recurrence | [repeat:: every day] |
Recurring task rules |
Task Statuses
| Status | Markdown | Type |
|---|---|---|
| Todo | - [ ] |
TODO |
| Done | - [x] |
DONE |
| In Progress | - [/] |
IN_PROGRESS |
| Cancelled | - [-] |
CANCELLED |
Query Blocks
Query tasks using fenced code blocks with tasks language:
```tasks
not done
due before tomorrow
sort by priority
```
Essential Query Instructions
Filtering:
done/not done- completion statusdue today/due before tomorrow/due after 2024-01-01scheduled this week/starts before todaypriority is high/priority is above mediumpath includes Projects//path does not include Archive/description includes meetinghas due date/no due dateis recurring/is not recurring
Sorting:
sort by due/sort by due reversesort by priority/sort by created/sort by done
Grouping:
group by due/group by priority/group by filename/group by folder
Display:
limit 10- max resultsshort mode- compact displayhide tags/hide task count/hide backlink
Global Task Filter
This vault uses #todo as the global task filter. Only tasks containing #todo are recognized by the plugin.
Reference Files
- Detailed query syntax: See references/queries.md
- Task format details: See references/task-format.md
- Recurrence rules: See references/recurrence.md
- Common examples: See references/examples.md
Working in This Vault
When modifying task-related files:
Check Obsidian settings at
.obsidian/plugins/obsidian-tasks-plugin/data.jsonfor:- Global task filter configuration
- Task format preference (should be Dataview)
- Custom status definitions
- Default date behavior
Preserve existing task metadata - don't strip fields when editing tasks
Use consistent date format:
YYYY-MM-DDPlace fields after description:
- [ ] Description [due:: 2024-01-15]Tags go before or within description, not after metadata fields