1# mermaid diagrams
2
3sublimated supports [mermaid](https://mermaid.js.org/) diagrams in two ways:
4
5## standalone .mmd files
6
7create a `.mmd` or `.mermaid` file with mermaid syntax. sublimated renders it server-side on push — no JavaScript needed in the browser.
8
9see the [mermaid docs](../mermaid/) for supported diagram types, styling, and demos.
10
11## embedded in markdown (planned)
12
7mermaid code blocks in markdown will be supported:
13two ways to include mermaid diagrams in markdown, both planned:
14
15### mermaid code blocks
16
17````
18```mermaid
19graph LR
20    A[start] --> B[end]
21```
22````
23
16not yet implemented. when ready, will render server-side via Selkie at push time — no client-side mermaid.js.
24not yet implemented. will render server-side via Selkie at push time — no client-side mermaid.js.
25
18## standalone .mmd files
26### content block transclusion
27
20create a `.mmd` or `.mermaid` file with mermaid syntax. sublimated renders it server-side on push — no JavaScript needed in the browser.
28embed an existing `.mmd` file using [iA Writer](ia-writer.md) or [Obsidian](obsidian.md) content block syntax:
29
22see the [mermaid docs](../mermaid/) for supported diagram types, how it works, and a demo file.
30```
31/diagrams/architecture.mmd
32```
33
34or:
35
36```
37![[architecture.mmd]]
38```
39
40not yet implemented. will embed the pre-rendered SVG from the file's `render_svg` representation — zero re-rendering cost.