Skip to content
for JiraRuns on Atlassian

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.

Mermaid Diagrams for Jira running inside Jira

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 in use

Mermaid Diagrams for Jira keeps your content inside Atlassian

Read the Trust Center
  • Runs 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

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.