A sequence diagram with an actor, a grouped box and numbered messages, drawn by Downer

Mermaid is the easiest way to keep diagrams next to your writing: a few lines of text in a code block become a flowchart, a sequence diagram or a timeline. The catch is seeing them. Many Mac apps either ignore the block or need a plugin to draw it.

Downer draws Mermaid diagrams itself, the moment a document opens.

What it handles

Every diagram type in the current Mermaid documentation, roughly 35 of them:

  • Flow and structure: flowcharts, class, state, entity-relationship and requirement diagrams
  • Time and plans: Gantt charts, timelines, journeys, kanban boards and Git graphs
  • Data: pie, XY, quadrant, radar, Sankey and treemap charts
  • Systems: architecture, block and C4 diagrams
  • Thinking: mind maps and the newer beta types

We test against all 1,242 examples from Mermaid’s own documentation, and every one of them opens and lays out.

Diagrams on their own

Keep a diagram in its own .mmd file? Open it in Downer and it fills the page. Press Space on it in Finder and Quick Look shows the same drawing.

Diagrams in your theme

Diagrams use the colours of your Downer theme, so a sequence diagram in Dracula looks like it belongs in Dracula. Switch between light and dark and the diagrams switch too.

Edit and see it change

Open the editor beside the preview and change a node or an arrow. The diagram updates as you type, so you can fix a layout without leaving the document.

Questions

Which Mermaid diagram types does Downer support?

All of the types in the current Mermaid documentation, about 35 in total. That includes flowcharts, sequence, class, state, entity-relationship, Gantt, pie, mind map, timeline, journey, Git graph, quadrant, Sankey, XY charts, kanban and architecture diagrams.

Can I open a .mmd file directly?

Yes. Downer opens .mmd and .mermaid files and shows the diagram as a page. Quick Look in Finder shows them too.

Do diagrams follow my theme?

Yes. Diagrams pick up the colours of whichever Downer theme you're using, in light or dark.

Try Downer on your Mac

Free for Apple silicon Macs running macOS 14 or later.

Download for Mac