Writing on diagrams
Practical notes on diagrams, docs, and developer ergonomics — published weekly.
Adding Beautiful Diagrams to Your Docusaurus / VitePress Site
Enabling Mermaid in Docusaurus or VitePress takes ten minutes. Making the diagrams stop looking generic takes another thirty. The whole path — plugin config, theming, and when to swap the renderer.
Beautify Mermaid Diagrams in Obsidian and VS Code (Without Leaving Your Editor)
You write Mermaid in Obsidian or VS Code, but the default pastel preview keeps undermining the note you're polishing. Two plugins put a themed renderer in the same pane — no round-trip to a web tool.
Generate Mermaid from Plain English with AI (CLI Walkthrough)
Most Mermaid friction isn't writing flowcharts — it's remembering syntax for sequence, ER, state, and class diagrams you draw twice a year. Five prompts, five diagrams, one CLI pipe.
Embed Mermaid in Notion: The 4 Working Approaches in 2026
Notion's native Mermaid block is fine for quick notes — but breaks the moment you want a theme, live updates, or a clean export. Here are the four embedding paths that actually work in 2026.
How to Render Mermaid Diagrams as SVG (and Stop Looking Like Every Other README)
A practical guide to rendering Mermaid as SVG — from the official CLI to custom themes, font fixes, dark mode, and the fastest path when you don't want to tune anything.