Platform guides
Where your Mermaid will actually run
Every platform pins its own Mermaid version and applies its own rules. These guides cover what renders, what gets sanitized, and how to ship diagrams that survive — with a studio preset matched to each target.
Mermaid on GitHub: what renders, what breaks, and how to ship safely
How GitHub renders Mermaid in READMEs, issues, and pull requests — the diagram types that travel well, the features that get sanitized, and a pre-publish checklist.
Mermaid on GitLab: rendering rules, size limits, and safe syntax
How GitLab renders Mermaid in markdown and wikis, the size and performance guards it applies, and how to keep diagrams inside the safe zone.
Mermaid in Notion: code blocks, previews, and their limits
How to embed Mermaid in Notion with code blocks, how the preview modes behave, and which Mermaid features to avoid in Notion pages.
Mermaid in Obsidian: native rendering, themes, and mobile parity
How Obsidian renders Mermaid natively in notes, how themes and CSS snippets affect diagrams, and the differences to expect on mobile.