Diagrams

mdgarden renders fenced ```mermaid blocks as interactive diagrams via a lazy-loaded client chunk (only fetched on pages that actually use one), and plain SVG/PNG images load like any other embed.

Flowchart

flowchart LR
  A[Markdown notes] --> B(mdgarden build)
  B --> C{Has frontmatter?}
  C -->|yes| D[Parse + apply]
  C -->|no| E[Use defaults]
  D --> F[Render HTML]
  E --> F
  F --> G[Static site]

Sequence diagram

sequenceDiagram
  participant You
  participant CLI as mdgarden serve
  participant Browser

  You->>CLI: save a .md file
  CLI->>CLI: rebuild changed pages
  CLI->>Browser: push reload event
  Browser->>Browser: refresh tab

A hand-drawn SVG

Not every diagram needs Mermaid — a plain SVG embeds the same way: