Skip to content
Superliner

Checkboxes and to-dos

Any note can carry a checkbox. It stays an ordinary note, so a to-do can have children, fields, supertags and its own page.

Add or toggle
⌘Return while editing or with notes selected
Remove
Note ▸ Remove Checkbox
Typed
\todo then Space, or [ ] then Space at the start of a note
Markdown copy
[ ] and [x] before the note, todo: in its frontmatter

Add a checkbox and check it

⌘Return is one key for the whole life of a to-do. The first press adds the box, and each press after that checks and unchecks it.

⌘ReturnAdd, check, uncheck. The caret never moves.
  1. Add it

    With the caret in a note, press ⌘Return. The note gets an empty box.

  2. Check it

    Press ⌘Return again, or click the box. Clicking toggles that note without starting an edit. A checked note is struck through.

  3. Keep going

    Press Return in a to-do and the note after it is an unchecked to-do too. This happens wherever the caret is, so the text after the caret moves into the new to-do. At the very start of a to-do that has text, Return inserts a plain note above it instead.

  4. Empty to-do

    Press Return in an empty to-do and its box is removed. The note stays where it is.

  5. Take the box away

    Choose Note ▸ Remove Checkbox. The text and everything under the note stay.

  6. Type the box

    At the start of a note, type [ ] and press Space for an open to-do, or [x] and Space for a checked one. This needs Convert Markdown as you type, which is on by default.

ReturnThe next note starts as an open to-do.

Work on several to-dos at once

Select several notes and ⌘Return adds a box to every one of them, or toggles the boxes they already have. It is one undo step.

To select them, press Esc to select the note you are editing and extend with ⇧ ↓, or drag in the empty space beside the text. See Select and move notes.

Launch checklist

Write the release notes
Book the venue
Two quotes are in
Confirm catering numbers
Send invitations
A to-do can have children, and those children can be to-dos too.

The Insert command list also has Check all, Uncheck all and Sort checked to bottom. They act on the child notes of the note you are editing. Mark as done and Mark as not done act on that note. These run from the list or with Return, never from Space.

In a code note

Copy, paste and the Markdown copy

Copying to-dos writes each box as [ ] or [x] at the start of its line. Pasting lines that begin with those marks makes to-dos again. See Copy and paste.

The Markdown copy adds todo: to the note's frontmatter, and writes [ ] or [x] before a to-do that sits in a list.

Count the to-dos on a page

The footer at the foot of each page counts the notes on it. When the page has to-dos, the footer also counts them and how many are done, for example: 3 notes in total · 1 to-do · 0 done.

Combine it

Limits

  • Built-in pages, and notes that are a supertag, field or saved search, cannot take a checkbox.