Mermaid Diagrams for Jira
Mermaid diagrams on every Jira issue: paste Mermaid or use the live editor, in your own colours
Draw Mermaid diagrams right on your Jira issues. Any mermaid code block in the description or a comment is drawn automatically, and a live editor lets anyone who can edit the issue add flowcharts, sequence diagrams, state machines and more. A Mermaid Diagrams page in the Apps menu shows how diagrams are used across the site. Diagrams are stored on the issue itself, so nothing leaves Atlassian.

What Mermaid Diagrams for Jira does
On every issue
A Mermaid diagrams section on the right of every issue, collapsed until needed, with a count
Panel and Activity tab
A panel under the description for wide diagrams, and a Diagrams tab next to Comments and History
Mermaid code blocks
Every code block set to mermaid in the description and comments is drawn, read-only
Tabs, list or grid
Show several diagrams the way you like; each person's choice is remembered
Open large
Any diagram full size in a modal, stepping through the rest with the arrow keys
Usage across the site
Diagrams by project and type, and when they last changed, daily, weekly or monthly
Search with JQL
Find issues with diagrams: mermaidDiagrams > 0
Live editor
Split code and preview, 12 templates, and theme, look and direction from the toolbar
Custom colour themes
Jira admins create site themes, each with a generated or hand-picked dark-mode version
Light and dark mode
Diagrams follow each reader's Jira theme
High-resolution PNG
Download any diagram as a sharp PNG, or view its Mermaid code
Edit permission respected
Only people who can edit the issue can add, change or delete its diagrams
What changes for your team
- See every diagram on an issue in one place, next to your other apps, with no setup per project
- Turn the Mermaid people already paste into descriptions and comments into real diagrams
- Add and edit diagrams in a live editor, starting from one of 12 templates
- Keep diagrams with the issue they explain: they are stored on the issue itself
- Give every diagram your brand colours, with a matching dark-mode version
- Let only people who can edit an issue change its diagrams
- See how teams use diagrams across the site, by project, type and when they last changed

Mermaid Diagrams for Jira keeps your content inside Atlassian
Read the Trust CenterRuns on Atlassian
Built on Forge, Atlassian's own app platform. Storage, authentication and permissions are Atlassian's, with no server of ours in the path.
Data residency
Your content stays in the region your Atlassian site is in and keeps the permissions you already set there.
Paperwork ready
A GDPR data processing agreement and a CAIQ Lite questionnaire are published for your security review.
DPACAIQ Lite
Questionsabout Mermaid Diagrams for JiraAsk us something else
Related apps
Charts - Reports and Graphs for Jira DashboardVisualize Jira issues with interactive, customizable charts and tables
Issue History+ for JiraEvery change to every issue, time in status and insights, in one place
Script Toolkit for JiraScripted fields, workflow rules, scheduled jobs, web triggers, panels and gadgets in JavaScript
Install Mermaid Diagrams for Jira on your site.
It runs on Forge, so it installs from the Marketplace and your content stays inside your own instance.
