docs / todos
Todos.
A todo is a list item with a box: - [ ] buy milk. You write todos in notes like any other text, and the file stays plain markdown.
The seven states
Each state has its own marker, the character inside the box.
| Marker | State | Shown as |
|---|---|---|
[ ] | open | an empty box |
[x] | done | struck through |
[-] | cancelled | greyed and labelled |
[>] | moved | greyed and labelled |
[<] | scheduled | its own marker |
[/] | in progress | its own marker |
[!] | priority | its own marker |
Any other character in the box is left as plain text.
Changing a state
| Key or action | Does |
|---|---|
| click the marker | toggle open ↔ done |
| ⌘↩ on the line | toggle open ↔ done |
| ⌘⇧↩ on the line | open a picker of all seven states |
| alt-click or right-click the marker | open the same picker |
In the picker, one key sets the state. Every change is one undo step.
Writing todos
- Start a box: type
[]then a space at the start of a list item, and it becomes an empty box. - Keep going: ⏎ after a todo starts the next one with an empty box.
- Stop: ⏎ on an empty todo ends the list with a blank line, so what you type next is a paragraph of its own, not part of the last todo.
- [x] pull last week's queue logs
- [/] try a second lane for batch jobs
- [-] ask for a bigger quota
- [ ] re-run the bench
In lists
A note's preview in the list draws its todos as [ ] and [x], so you can see what's open without opening the note.