Mermaid Support
Mermaid Plugin brings powerful diagram rendering directly into your Publii site. Whether you’re building documentation, technical tutorials, or visual storytelling content, this plugin makes it simple to display clean, dynamic diagrams using Markdown syntax. Once installed, all you need is a fenced code block starting with ```mermaid - and your flowcharts, sequence diagrams, and more will be automatically rendered using the popular Mermaid.js library.

Key features
- Markdown-friendly rendering: Use fenced code blocks like
```mermaid
to display diagrams without shortcodes or embeds. - Works across your site: Insert Mermaid diagrams into posts, pages, and even excerpts.
- Automatic library loading: The Mermaid.js script is included only when needed – no manual setup required.
- Theme-aware support: Diagrams automatically adapt to light and dark mode using the visitor’s system preferences.
- No configuration needed: The plugin is plug-and-play, but can be customized further if needed.
This plugin is ideal for anyone writing structured content – from developers to educators – and provides a frictionless way to integrate live diagrams into your static website.
Requirements and compatibility
- Browser:
- Edge, Firefox, Chrome, Safari, Opera
- Requirements:
- Publii 0.46.5 and up