# Markdown in Unmarked
Render Mermaid diagrams in Unmarked
Last updated July 2026
Fence a code block with mermaid and Unmarked draws it as a diagram in Read mode: flowcharts, sequence diagrams, and the other types Mermaid supports. It renders on your Mac, with nothing fetched from the web.
Write the diagram
Put the Mermaid text inside a fenced code block tagged mermaid:
```mermaid
flowchart TD
A[Draft] --> B[Review] --> C[Publish]
```
In Write mode you see and edit that text. Switch to Read mode (⌘E) and it becomes the drawn diagram.
How it renders
- Diagrams follow your theme and your light or dark setting, so they match the rest of the app.
- Rendering happens on your Mac: the Mermaid engine ships inside Unmarked. Your files stay on your Mac.
- Click a diagram to open it in the zoom viewer, handy for a large flowchart. Live Text lets you select and copy the label text.
- If the Mermaid source has an error, the block simply stays an ordinary code block. No popups, nothing breaks.
Diagrams in your exports
A rendered diagram carries into an export. PDF and Word embed it as an image sized to fit the page; a self-contained HTML export embeds it in the file, so the page still works offline. Copy as Rich Text keeps the Mermaid code block instead.
Diagrams are rendered by Mermaid (MIT License).
Unmarked is a free, private Markdown reader and editor for Mac. Read the story , or get in touch.