Apr 7, 2026 965 B markdown of v5

mermaid diagrams

sublimated supports mermaid diagrams in two ways:

standalone .mmd files

create a .mmd or .mermaid file with mermaid syntax. sublimated renders it server-side on push — no JavaScript needed in the browser.

see the mermaid docs for supported diagram types, styling, and demos.

content block transclusion

embed an existing .mmd file using iA Writer or Obsidian content block syntax:

/diagrams/architecture.mmd

or:

![[architecture.mmd]]

the pre-rendered SVG from the file's render_svg representation is embedded inline — zero re-rendering cost.

this also works for .excalidraw files. see excalidraw for details.

inline mermaid code blocks (planned)

```mermaid
graph LR
    A[start] --> B[end]
```

not yet implemented. will render server-side via Selkie at push time — no client-side mermaid.js.