Simplify

Tabs & Mermaid for Jira: Setup and Usage Guide

Step-by-step guide to adding tabs, writing Mermaid diagrams, and cloning tab layouts across Jira issues and projects with Tabs & Mermaid for Jira.

Getting Started

Access the Tabs Panel

  • In any Jira issue or project page, locate the “Tabs & Mermaid” section. This will appear as a new panel or tab, depending on your configuration.

Create and Edit Tabs

  • Click “Add Tab” to create a new tab.

  • Click “Show Description” to display the description field.

  • Type a description and click Save.

  • Create a diagram. Click on the “Create Content” or “Edit Content” button.

  • Supported diagram types include:

    • Flowcharts
    • Sequence diagrams
    • Gantt charts
    • Class diagrams
    • ER diagrams

  • Example:

mindmap
  root((mindmap))
    Origins
      Long history
      ::icon(fa fa-book)
      Popularisation
        British popular psychology author Tony Buzan
    Research
      On effectiveness<br/>and features
      On Automatic creation
        Uses
            Creative techniques
            Strategic planning
            Argument mapping
    Tools
      Pen and paper
      Mermaid

  • Click “Preview” to see the rendered diagram.

  • To rename a tab title, click on the tab label, update the text, and save.

  • To reorder tabs, click and hold on a tab, then drag it to a new position.

Clone Tabs Between Issues or Projects

  • Click the “Clone” icon to copy the entire set of tabs to another issue or project.

  • Select the target location and confirm the operation.

Enjoy a Clean, Structured Jira Experience

Tabs & Mermaid for Jira brings organization and clarity to your documentation workflow—right where your team collaborates.