---
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]]（查询语法是上下文驱动任务的核心机制）