Mermaid Diagrams for Jira & Confluence
Setup & Usage Guide
Installation
- Install the app from the Atlassian Marketplace
- Once installed, open any Jira issue or Confluence page
- The Mermaid Diagrams panel appears automatically in the sidebar and as a full-width panel below the issue description
No configuration is required. The app works immediately after installation.
How It Works
The app automatically scans your Jira issue descriptions, comments, and Confluence page content for Mermaid code blocks. When it finds one, it renders the diagram inline.
To add a diagram, simply create a code block with the language set to mermaid in the Jira or Confluence editor:
```mermaid
flowchart LR
A[Start] --> B[Process]
B --> C{Decision}
C -->|Yes| D[Done]
C -->|No| B
```
Supported Diagram Types
Features
Zoom & Pan
Navigate complex diagrams with mouse, trackpad, touch, or keyboard shortcuts. Ctrl/Cmd + scroll to zoom, click and drag to pan. Press F to fit, 0 to reset.
Export
Download diagrams as SVG or PNG, or copy directly to your clipboard. Exports include proper backgrounds and full styling.
Dark & Light Mode
Automatically syncs with your Jira or Confluence theme. Diagrams re-render with the correct color palette when you switch modes.
Fullscreen View
Click "Expand" or "Full Screen" for a distraction-free view of any diagram with full zoom and export controls.
View Source
Toggle between the rendered diagram and the raw Mermaid source code to inspect or copy the syntax.
Where Diagrams Appear
- •Sidebar panel: A compact preview in the right sidebar of any Jira issue. Click "Expand" for the full view.
- •Full-width panel: Below the issue description, with full zoom, pan, and export controls.
- •Confluence pages: Renders Mermaid blocks found in page content.
The app detects diagrams in both issue descriptions and comments, including paginated comments.
FAQ
My diagram isn't rendering. What should I check?
Make sure the code block language is set to "mermaid" (not "text" or blank). Check the Mermaid syntax using the Mermaid Live Editor to validate your diagram.
Does the app modify my Jira data?
No. The app has read-only access and never creates, modifies, or deletes any content.
Does it work with Confluence?
Yes. The app supports both Jira issues and Confluence pages.
Is my data sent to external servers?
No. All rendering happens in your browser. No data is collected or transmitted. See our Security Statement for details.
Support
Need help? Reach out to us: