Writing on diagrams as code.
Practical posts on cloud architecture diagrams, validating them against AWS, Azure, and GCP best practices, and drawing real production systems as text.
Does Doxygen support Mermaid diagrams? Yes — since 1.17.0, and here is how to enable it
Doxygen shipped native Mermaid support in 1.17.0 (30 April 2026): the @mermaid, @endmermaid and @mermaidfile commands plus five config options. Here is how to turn it on, the CLI vs client-side render modes, the CDN gotcha, and why AWS icons still need an exported image.
Does Bitbucket render Mermaid diagrams? What works, what doesn't, and the workaround
Bitbucket does not render Mermaid natively — the feature request was closed Won't Fix and its replacement is still Gathering Interest. Here is every rendering route compared, why the apps still break AWS icons, and why PNG beats SVG in a Bitbucket README.
How do you know if your AWS architecture diagram is correct?
An AWS diagram can render perfectly and still be wrong. Here are the placement and connectivity rules that make one correct — and how to check them free.
How do you diagram a serverless AWS architecture (Lambda, API Gateway, DynamoDB) in Mermaid?
Diagram a serverless AWS stack in Mermaid architecture-beta: why Lambda, API Gateway, DynamoDB, S3, and Cognito sit at the Region level with no VPC, the request path to draw, and the one VPC-attached Lambda exception.
How do you diagram an AWS VPC (subnets, NAT, and gateways) in Mermaid?
Diagram an AWS VPC in Mermaid architecture-beta: where public vs private subnets, the NAT gateway, Internet Gateway, and S3 gateway endpoints belong.
How do you turn Terraform into an AWS architecture diagram with Mermaid?
Terraform provisions AWS but gives you no readable architecture diagram — terraform graph only emits a low-level dependency graph. Here is how to turn your Terraform, or its plan JSON, into a validated Mermaid architecture-beta diagram: the diagramming options compared, an LLM grounding workflow, and a worked multi-tier example checked at zero rule violations in LatixEngine.
Mermaid vs AWS Application Composer: which should you use for AWS architecture diagrams?
AWS Application Composer (now Infrastructure Composer) builds and deploys infrastructure; Mermaid architecture-beta diagrams document and communicate it. A side-by-side comparison of what each is for, where each wins, and the workflow that uses both together — with a validated Mermaid example.
What are the most common AWS architecture patterns in Mermaid (with copy-paste examples)?
Five copy-paste AWS architecture diagrams in Mermaid: three-tier web, serverless API, static site, microservices, event-driven — validated at zero violations.
How does Mermaid architecture-beta syntax work? A complete reference
Complete Mermaid architecture-beta syntax reference — groups, services, port-based edges, junctions, and {group} edges — with AWS examples you validate free.
What are the most common AWS architecture mistakes (and how do you catch them)?
The most common AWS architecture mistakes — public databases, single-AZ deployments, API Gateway wired to RDS, misplaced NAT gateways, managed services inside a VPC — why each is wrong, and how to catch them in the diagram before they ship.
How do you render and embed Mermaid AWS architecture diagrams in GitHub, Notion, and Confluence?
Your Mermaid AWS diagram breaks in GitHub, Notion, and Confluence. Here's the free export-and-commit workflow that makes it render identically everywhere.
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?
Draw AWS architecture diagrams in Mermaid step by step: architecture-beta syntax, VPC and subnet examples, and 856 native AWS icons — free, in your browser.