## [Map States & Approval Workflows in Confluence with Mermaid](/blog/mermaid-state-diagram-workflow-confluence.md)

September 24, 2026 ·

<!-- -->

6 min read

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

The issue workflow lives in a wiki page that says "the approval chain is: team lead, then manager, then finance". The config says otherwise, the Jira post-function disagrees, and the incident report asks "who actually approved this?" — with three different answers on screen. A prose paragraph cannot hold a workflow; a diagram can, if it *is* the workflow.

**Quick answer:** document state machines and approval chains in Confluence as Mermaid `stateDiagram-v2`, rendered by [Mermaid Plus for Confluence](https://marketplace.atlassian.com/apps/1236814/mermaid-plus-diagrams-for-confluence/). Every legal state, every transition, every human decision on a labeled arrow — in editable text that stays true. This post gives you three copy-paste examples: an issue lifecycle, a spending approval chain, and a retry loop with a timeout.

**Tags:**

* [confluence](/blog/tags/confluence.md)
* [mermaid](/blog/tags/mermaid.md)
* [state-diagram](/blog/tags/state-diagram.md)
* [workflow](/blog/tags/workflow.md)
* [approval](/blog/tags/approval.md)
* [how-to](/blog/tags/how-to.md)

[**Read more**](/blog/mermaid-state-diagram-workflow-confluence.md)