## [UML Use Case Diagrams in Confluence (Mermaid, Copy-Paste)](/blog/uml-use-case-diagram-confluence.md)

September 24, 2026 ·

<!-- -->

4 min read

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

The use case diagram is the scope picture: actors on the outside, what the system does for them on the inside, and — the reason product and engineering fight — the line between them. In Confluence that picture usually comes from a diagramming tool export that goes stale the moment scope moves.

Mermaid 12 added the syntax to render UML use case diagrams from text — `usecase-beta` — and Enhanced Markdown for Confluence renders it in the same macro as everything else on the page. This guide gives you the syntax and two copy-paste diagrams.

**Tags:**

* [confluence](/blog/tags/confluence.md)
* [uml](/blog/tags/uml.md)
* [use-case-diagram](/blog/tags/use-case-diagram.md)
* [mermaid](/blog/tags/mermaid.md)
* [markdown](/blog/tags/markdown.md)
* [how-to](/blog/tags/how-to.md)
* [engineering](/blog/tags/engineering.md)

[**Read more**](/blog/uml-use-case-diagram-confluence.md)