Auto-sync: 2026-04-27 08:02

wiki/concepts/TaskQuerySyntax.md

@@ -0,0 +1,41 @@
+---
+title: "TaskQuerySyntax"
+type: concept
+tags: []
+sources: []
+last_updated: 2026-04-27
+---
+
+## Aliases
+- Tasks 查询语法
+- Obsidian Tasks 查询
+- Tasks 代码块查询
+
+## Definition
+TaskQuerySyntax（任务查询语法）是 Obsidian Tasks 插件提供的查询语言，允许用户在任意笔记中嵌入任务筛选代码块，动态展示符合条件（如截止日期、优先级、完成状态）的任务列表。
+
+## Key Characteristics
+- 嵌入式查询：在任意 Markdown 笔记中插入 ````tasks` ```` 代码块，结果随任务状态实时更新
+- 自然语言条件：支持 `not done`、`due before tomorrow`、`sort by priority` 等可读性强的条件
+- 多条件组合：可同时筛选日期范围、优先级、标签、文件夹等多个条件
+- 排序控制：支持按优先级、日期、路径等多维度排序
+- 灵活性：查询可以放在任何笔记中，形成"上下文感知"的任务视图
+
+## Example
+````
+```tasks
+not done
+due before tomorrow
+sort by priority
+```
+````
+含义：筛选所有未完成、明天之前到期的任务，并按优先级排序。
+
+## Related Concepts
+- [[RecurringTask]]：查询中常配合重复任务使用，筛选即将到来的周期任务
+- [[MarkdownBasedTask]]：查询基于 Markdown 语法创建的任务
+- [[ContextDrivenTask]]：查询嵌入笔记上下文，实现"在笔记中看到相关任务"
+
+## Connections
+- [[ObsidianTasksPlugin]] ← provides ← [[TaskQuerySyntax]]（Tasks 插件提供查询功能）
+- [[TaskQuerySyntax]] ← enables ← [[ContextDrivenTask]]（查询语法是上下文驱动任务的核心机制）