37 lines
1.0 KiB
Markdown
37 lines
1.0 KiB
Markdown
---
|
|
description: A checkbox item tracked as a queryable object.
|
|
tags: glossary
|
|
references:
|
|
- plugs/index/task.ts
|
|
- client/codemirror/task.ts
|
|
---
|
|
|
|
The task notation syntax is a [[Markdown]] extension to write down tasks.
|
|
|
|
Its most basic form is:
|
|
|
|
* [ ] This is my first task
|
|
|
|
which renders as follows:
|
|
|
|
* [ ] This is my first task
|
|
|
|
SilverBullet allows you to simply toggle the complete state of a task by clicking the checkbox.
|
|
|
|
All tasks across your space are automatically [[Object/task|indexed]] and can therefore be [[Space Lua/Integrated Query|queried]].
|
|
|
|
# Custom states
|
|
Tasks support the default `x` and ` ` states (done and not done), but custom states as well. Support for this is still basic, however.
|
|
|
|
Example:
|
|
|
|
* [NOT STARTED] Task 1
|
|
Fix having global variables work in markdown.expandMarkdown
|
|
* [IN PROGRESS] Task 2
|
|
|
|
Restrictions:
|
|
|
|
* Task states cannot contain `:` to avoid ambiguity with [[Attribute]] syntax.
|
|
|
|
To define custom states explicitly (and get code completion for them), use the [[API/taskState]] API.
|