A code fence marked mermaid becomes a diagram. Mermaid 12 draws it in your browser, which is also what happens in the desktop app.
Preview
How a render travels
flowchart LR
A[Markdown in the box] --> B[POST /api/render]
B --> C[Markdig]
C --> D[Sanitizer]
D --> E[HTML back to the page]
E --> F[Mermaid and KaTeX]
sequenceDiagram
participant B as Browser
participant S as Server
B->>S: POST /api/render
S->>S: parse, render, sanitize
S-->>B: sanitized HTML
B->>B: draw diagrams, typeset math
Mark a fenced code block as mermaid and its contents go to Mermaid instead of being
printed as code:
```mermaid
flowchart LR
A[Markdown] --> B{Fence marked mermaid?}
B -- yes --> C[Mermaid draws it]
B -- no --> D[Syntax highlighting]
```
That is the same thing GitHub does with a mermaid fence, and the same thing the desktop
app does. The document is rendered to HTML first and the diagram is drawn afterwards, in
your browser.
Which version, and where it comes from
Mermaid 12.0.0, bundled with the page. Nothing is fetched from a CDN, so the version you
get is the one MdReader shipped and it does not change under you.
The bundle is five megabytes, so it is fetched only once a document actually contains a
diagram. A page with no mermaid fence never downloads it.
Getting the diagram out
There is no export button. The diagram is an SVG element in the page, so printing to PDF
keeps it as a vector drawing that stays sharp at any zoom. For a file, Mermaid's own
editor at https://mermaid.live has one, and takes the same source.
Errors, themes and scrolling
A diagram that Mermaid cannot parse shows Mermaid's own error message in the place the
diagram would have taken, and the rest of the document renders as normal. One bad diagram
does not cost you the page.
Switching between light and dark redraws every diagram with the matching palette, rather
than leaving dark lines on a light box.
Diagrams below the fold are drawn as you scroll towards them. A document with thirty
diagrams in it stays responsive because twenty-nine of them have not been drawn yet.
Questions
Which Mermaid version is this?
Mermaid 12.0.0. It is bundled with the page, so nothing is fetched from a CDN and the version only changes when MdReader ships a new one.
What happens when a diagram has a syntax error?
Mermaid's own error message appears where the diagram would have been, and the rest of the document still renders.
Can I export the diagram as a file?
There is no export button. The diagram is an SVG in the page, so printing the page to PDF keeps it as a vector drawing rather than a picture of one.
Does the diagram follow the dark theme?
Yes. Switching the theme redraws every diagram on the page with Mermaid's matching palette, and printing redraws them light so they are legible on paper.