Skip to content

The editor

mdai shows you a formatted document and writes plain Markdown to disk. There is no preview pane to keep in sync, because there is nothing to sync: what you see is the file.

Type **bold** and the text turns bold as you close the second *. Put the cursor back inside that word and the ** markers come back, so you can edit them. Move away and they hide again.

This is why the file on disk never surprises you. Write this:

# Notes from the call
The client wants **two** things:
1. A shorter form
2. A [link](https://example.com) to the price list
> "Ship the form first."

…and that is exactly what is stored — no wrapper, no HTML, no hidden block.

Action macOS Windows / Linux
New tab ⌘T Ctrl+T
Close tab ⌘W Ctrl+W
Next tab ⌃Tab Ctrl+Tab
Previous tab ⌃⇧Tab Ctrl+Shift+Tab

Note the tab-switching keys use Control on every platform, including macOS — ⌘Tab belongs to the operating system, not to us.

Your open tabs come back the next time you start mdai, with the same tab in front.

Press ⌘2 / Ctrl+2 for the Outline panel. It lists the headings of the document you are in, and clicking one jumps to it. It rebuilds as you type, so a heading you just wrote is in the list before you finish the sentence.

Headings are ordinary Markdown — # through ######.

Type / at the start of a block, or after a space, and a small menu appears next to the cursor. Keep typing to narrow it.

You type You get
/table An empty table, ready to fill in
/quote A blockquote
/date Today’s date, written into the text
  • Enter or Tab picks the highlighted entry
  • ↑ ↓ move through the list
  • Escape closes the menu and leaves the / text alone

The /query you typed is removed from the document when the command runs, so nothing is left behind. Inside a code block or inline code, / is just a slash — the menu does not open there.

View → Toggle Focus Mode dims everything except the part you are writing. It has no keyboard shortcut on purpose: the combination that would fit is taken by the window manager on one of the three platforms, and a shortcut that works in two places out of three is worse than none. Use the menu or the command palette (⌘K / Ctrl+K).

Action macOS Windows / Linux
Save ⌘S Ctrl+S
Save As… ⌘⌥S Ctrl+Alt+S

Save As uses ⌘⌥S / Ctrl+Alt+S rather than the ⇧⌘S you may know from other editors — that combination never reaches the app on one of our platforms, so it would have been a key that silently does nothing.