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.
Syntax reveals itself where the cursor is
Section titled “Syntax reveals itself where the cursor is”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 form2. 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.
The outline
Section titled “The outline”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 ######.
Slash commands
Section titled “Slash commands”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.
Focus mode
Section titled “Focus mode”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).
Saving
Section titled “Saving”| 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.