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