Rich markdown editor

Markdown files open in a rich editor by default — slash menu, toolbar, inline previews for images and code, internal link autocomplete. Toggle to raw Monaco whenever you want with Cmd-Shift-M.

Rich markdown editor — slash menu, inline previews, internal-link autocomplete
Rich markdown editor — slash menu, inline previews, internal-link autocomplete

Slash menu

Type / on an empty line to open the slash menu: headings, lists, code blocks, callouts, images, mermaid diagrams, and toggle blocks.

Use /toggle-text for collapsible notes and /toggle-h1 when the toggle summary should read like a top-level heading. Orca saves both as portable <details> / <summary> markdown so the file still previews outside Orca.

Type [[ to start a wiki-style link. Orca autocompletes file paths within the worktree and inserts a relative link.

In-editor markdown search respects rendered text, not raw markdown — so searching for "Install" finds a heading whether written as # Install or <h1>Install</h1>.

Review annotations

When you're reviewing markdown in Orca's rich editor, select rendered text to add an annotation without switching back to raw markdown. Orca keeps the note tied to the selected source range so it can show the comment while you continue editing the rendered document.

Front matter

YAML front matter (the --- block at the top of a file) is hidden from the rendered preview by default — agent-generated docs and static-site posts read more cleanly without the metadata fence. Use the More actions menu (the button in the editor toolbar) and pick Show front matter to render it inline; the toggle is per-file, so showing it on one document doesn't reveal it on the rest.