Skip to content

Editing tasks

A task starts as a line of text and grows only as much as it needs to. A single click in the list just selects a task; to edit it, open its detail panel.

Press ⏎ on a selected task, or double-click it, to open the detail panel. This is where you edit a task — including its name, which you rename right at the top of the panel:

  • Title (required) — editable in place; the panel’s loudest element
  • Description (optional, Markdown — see formatting your notes)
  • Project
  • Deadline
  • Recurrence

The panel has two tabs — Details (everything above) and History (the task’s timeline).

On macOS and iPad the panel docks to the right of the window, so the rest of your list stays in view — you keep your place instead of dropping into a full-screen editor. While it’s open, the keyboard works inside the panel; click (or tap) another task to point the panel at that one instead, and press ⎋ to close it. Switch to another section and the panel follows your selection there — or closes if that section is empty — so it never lingers on a task you’ve navigated away from. On iPhone the editor opens as its own screen.

A subtle accent follows the task: warm plum when it’s in Today, teal everywhere else.

Open the panel (⏎ or double-click) and edit the title at the top. It saves when you press ⏎ or click away; ⎋ cancels. Typing a #project, a date, or a recurrence word in the title still runs smart parsing here, just like capture.

A single click on a task in the list selects it — it doesn’t start a rename.

The description is plain Markdown, formatted as you type. There’s no separate preview: what you see while reading is what you edit. The ** and * around bold and italic text disappear once it’s formatted, and come back, in faint grey, on the line you’re editing, so you can change them. Headings, quotes and bullets keep their markers.

Write To get
# , ## , ### at the start of a line A heading
**bold**, *italic*, ~~struck~~ bold, italic, struck
`code` and ``` fences Inline code and code blocks
[text](https://…) or a bare link A link you can click (or tap)
> A quote
- , * or 1. A list

Lists do the typing for you:

  • ⏎ starts the next item (2. follows 1.). On an empty item it steps back out a level, then out of the list.
  • ⇥ indents an item under the one above, up to four levels; ⇧⇥ brings it back. On iPhone and iPad, use the indent buttons above the keyboard.
  • Numbered lists count on their own at each level: 1. at the top, a. one level in, i. two levels in.
  • ⌫ right after a bullet removes the bullet; on an empty item it clears the line back to the margin.

⌘B and ⌘I bold or italicise the selection. In the description ⏎ is a new line, so press ⌘⏎ to close the task (or add it, in capture), or ⎋ to leave the notes first.

There are no checkboxes. A checklist inside a task is a set of subtasks, and Rymi keeps tasks single. If something needs steps, it may want to be a project.

Everything — including the title — lives in the detail panel. Archived tasks open in a read-only version, so you can look back without changing the record.