# Markdown in Unmarked

Render Mermaid diagrams in Unmarked

Last updated August 2026

Fence a code block with mermaid and Unmarked draws it as a diagram in Read mode and Present: 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.

Present shows the same diagram at its reading size. It stays correct and readable rather than expanding to fill the slide.

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