## [System Architecture Diagrams in Confluence with Mermaid C4](/blog/mermaid-c4-system-architecture-confluence.md)

September 24, 2026 ·

<!-- -->

6 min read

[NGPilot](https://ngpilot.com)

The onboarding doc says "check the architecture diagram" and the architecture diagram shows a monolith from 2023 that the team decommissioned in the spring. Nobody is lying — the draw\.io file lives on one person's laptop, and the wiki holds a screenshot nobody owns. An architecture that only exists as a static export rots silently, because the thing you would edit is invisible to review.

**Quick answer:** document system architecture in Confluence as Mermaid text — `C4Context` for the system in context, `architecture-beta` for the deployment, `block-beta` for the topology you want laid out precisely — rendered by [Mermaid Plus for Confluence](https://marketplace.atlassian.com/apps/1236814/mermaid-plus-diagrams-for-confluence/). Every level stays an editable code block, so the wiki's architecture changes in the same review that changes the system. This post gives you three copy-paste examples.

**Tags:**

* [confluence](/blog/tags/confluence.md)
* [mermaid](/blog/tags/mermaid.md)
* [architecture](/blog/tags/architecture.md)
* [c4-model](/blog/tags/c-4-model.md)
* [block-diagram](/blog/tags/block-diagram.md)
* [how-to](/blog/tags/how-to.md)

[**Read more**](/blog/mermaid-c4-system-architecture-confluence.md)