Skip to content

Diagram Integration

The Solospec static renderer automatically injects lightweight client-side runtimes to power diagrams like Mermaid and LikeC4 when they are detected in the document.

You can author Mermaid diagrams naturally utilizing standard gated code blocks. The Solospec runtime will identify these blocks and asynchronously render them.

```mermaid
sequenceDiagram
participant Alice
participant Bob
Alice->>John: Hello John, how are you?
loop Healthcheck
John->>John: Fight against hypochondria
end
Note right of John: Rational thoughts <br/>prevail!
John-->>Alice: Great!
John->>Bob: How about you?
Bob-->>John: Jolly good!
```

you can also use include semantics to include mermaid diagrams from other files:

:::include ./diagrams/sequence.mmd:::

Solospec seamlessly manages the Mermaid and LikeC4 initialization configuration to make sure it respects the current runtime mode (e.g., inheriting dark mode seamlessly during theme-toggling in the Bikeshed theme).