Skip to content
AndonDocs
GitHub
Use the board / Planning and organising

Card notes

View as MarkdownThe same text, at this page's address plus .mdOpen in ClaudeAsk questions about this pageOpen in ChatGPTAsk questions about this page

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

  1. Open the card. Its notes show rendered.
  2. Click the text (not a link or a checkbox) to edit it.
  3. Pick Write, Split or Preview. Split shows the source and the preview side by side when the notes are wide enough.
  4. 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.

  • / 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-42 shows 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).