# 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

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**.

## 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-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).
