Diagrams

Embedding Mermaid diagrams in Reinhardt documentation.

Reinhardt's documentation site renders fenced code blocks tagged ```mermaid as live diagrams. Use them for architecture overviews, sequence flows, and state machines instead of ASCII art.

Flowchart

flowchart LR
    Client -->|HTTP| Router
    Router --> Middleware
    Middleware --> Handler
    Handler --> DB[(Database)]
    DB --> Handler
    Handler --> Client

Sequence diagram

sequenceDiagram
    participant U as User
    participant W as Web
    participant A as Auth
    U->>W: GET /dashboard
    W->>A: validate session
    A-->>W: ok
    W-->>U: 200 dashboard.html

Authoring notes

  • Diagrams render client-side via Mermaid, loaded from cdnjs only on pages that contain at least one ```mermaid block.
  • Colors follow the site's light/dark theme automatically and re-render on theme toggle.
  • Keep the diagram source readable in the Markdown — it ships as the fallback if the Mermaid runtime fails to load.