Card notes
A card’s notes are Markdown, and they stay Markdown: a run’s prompt gets exactly what people wrote. The editor helps you write it without adding syntax of its own. Comments use the same editor.
Write notes
- Open the card. Its notes show rendered.
- Click the text (not a link or a checkbox) to edit it.
- Pick Write, Split or Preview. Split shows the source and the preview side by side when the notes are wide enough.
- Click away to save, or press ⌘↩ (Ctrl+Enter) to save and go back to the rendered view.
To give Split more room, drag the line between the card’s main column and its details rail. Double-click the line (or press Home with it focused) to put it back. Your width is remembered in this browser. The line shows only when the card is wide enough; the phone has no rail.
Shortcuts
⌘ on a Mac, Ctrl elsewhere:
| Keys | Does |
|---|---|
| ⌘B, ⌘I, ⌘E, ⌘⇧K, ⌘⇧X | bold, italic, inline code, link, strikethrough (press again to undo). ⌘K stays the app’s search |
| ⌘⌥1, ⌘⌥2, ⌘⌥3 | heading 1 to 3 |
| ⌘⇧7, ⌘⇧8, ⌘⇧9, ⌘⇧. | numbered list, bulleted list, checklist, quote |
| ⌘⌥C | code block |
| Enter, Tab, ⇧Tab | continue a list (an empty item ends it), nest, un-nest. Outside a list, Tab moves focus |
⌘Z undoes a toolbar action the same way it undoes typing. On a narrow panel and on the phone, the toolbar keeps Bold, Italic, Link, Checklist and Attach, and the rest sit under More.
Blocks, mentions and links
/at the start of a line opens the block menu: headings, lists, checklist, quote, code block, table, divider, and the templates Spec, Bug report and Checklist.@mentions a member:@ada.lovelace, their name in lower case with dots between the words. It shows with their name. In a comment, the person is notified.#links a card:#ENG-42shows as a chip with the card’s title and state. It works for the key of the card’s linked Linear or Jira issue; a card’s own Andon key, such as#WEB-12, doesn’t become a link.- Paste or drop files, or click the paperclip. Each file becomes a card attachment and is linked where the cursor was. An image shows in the preview. A run gets the file itself.
- Fenced code is highlighted by its language (
```ts), and pipe tables render as tables.
Checklists
- [ ] and - [x] items render as checkboxes you can tick in the rendered view; the change saves at once, with Undo
in the toast. The card face counts them: 2 of 6. Items inside code blocks don’t count.
A run ticks them too: when its report says which items its work finished, Andon ticks those in the notes, so a card that ran and merged shows what was done rather than 0 of 6. It ticks only an item that still reads as the run saw it, and never unticks one.
When someone saved first
There is no live co-editing. If the notes changed while you had unsaved edits, saving stops and shows both versions as a line diff: − is only in theirs, + only in yours. Choose Save mine over theirs, Use theirs (drops your edits) or Keep editing (your next save goes over theirs).
