Writing on diagrams as code.
Practical posts on Mermaid architecture diagrams, native cloud icons, and how to draw real production systems as text.
How do you render and embed Mermaid AWS architecture diagrams in GitHub, Notion, and Confluence?
GitHub, GitLab, Notion, and Obsidian render plain Mermaid natively, but architecture-beta diagrams with AWS icon packs are not reliably supported on any platform yet. Here is the export-and-commit workflow that renders identically everywhere, platform by platform.
How do you get ChatGPT or Claude to generate valid Mermaid AWS architecture diagrams?
ChatGPT, Claude, and Gemini all produce Mermaid architecture-beta source on demand — and all three hallucinate AWS icon slugs. Here is the prompting pattern that fixes it, the slugs they get wrong most often, and a side-by-side comparison of grounded vs ungrounded output.
How do you draw AWS architecture diagrams in Mermaid?
A practical walkthrough of drawing AWS architecture diagrams in Mermaid: the architecture-beta syntax, native AWS icons, VPC and subnet examples, exports, and how it compares to draw.io and Lucidchart.