Beauty Diagram
Blog

Writing on diagrams

Practical notes on diagrams, docs, and developer ergonomics — published weekly.

AllTutorialOpinionComparisonWorkflowListicleStory
Which Tools Support Mermaid Natively? A Checked List
ComparisonFeatured

Which Tools Support Mermaid Natively? A Checked List

GitHub, GitLab, Notion, Obsidian, VS Code and Azure DevOps render Mermaid natively. Confluence, Slack and Google Docs do not. Every row checked against the vendor's own documentation.

Aug 9, 202610 min read
Diagrams as Code in 2026: Mermaid, PlantUML, D2, Excalidraw — When to Use What
ComparisonJul 20, 2026

Diagrams as Code in 2026: Mermaid, PlantUML, D2, Excalidraw — When to Use What

Four diagrams-as-code tools are worth learning in 2026. Each is best at a different job — a comparison, plus the honest tradeoffs nobody puts on the marketing page.

Read article →
Mermaid vs PlantUML in 2026: Which to Pick for Engineering Docs
ComparisonJun 2, 2026

Mermaid vs PlantUML in 2026: Which to Pick for Engineering Docs

Mermaid and PlantUML solve the same problem with different trade-offs. Here's a 2026 comparison on syntax, layout quality, diagram coverage, and ecosystem — with a decision rule at the end.

Read article →