Skip to main content
Skip table of contents

Create Mermaid diagrams

Find out the easiest way to insert Mermaid diagrams into your Confluence pages.

Mermaid diagrams are an awesome tool to visually represent complex information using simple text syntax. Whether you're creating flowcharts, sequence diagrams, Gantt charts, or entity relationship diagrams, Mermaid makes it easy to convert plain text into professional-looking diagrams with minimal effort.

This guide will walk you through the process of creating and inserting Mermaid diagrams into your Confluence pages using Capable Diagrams for Confluence.

https://www.youtube.com/watch?v=7Qsvfb8oFV0

Step 1: Open Capable Diagrams Macro

  1. Open the Confluence page where you want to insert a Mermaid diagram.

  2. Type /diagram where you’d like to insert the diagram

  3. Press enter to insert the diagram macro

image-20241024-142253.png

Step 2: Select Text Editor

Choose the text editor option to view templates.

Screenshot 2024-10-24 at 15.23.18.png

Step 3: Choose from a template

Either start from scratch or select a template to start from.

Screenshot 2024-10-24 at 15.25.02.png

Step 4: Add Your Mermaid Diagram Syntax

In the Mermaid editor, simply write the syntax for your diagram with a number of useful features that our competitors don’t offer.

Manual Editing

Write your own Mermaid syntax to customize the diagram exactly as needed. This gives you full control over the structure and design.

AI-Generated Diagrams

Use the ‘Capable AI’ button to automatically generate diagrams. Provide a brief description, and the AI will create the corresponding Mermaid syntax for you, saving time on complex diagrams.

AI Suggestions (Press Tab)

As you type, the AI offers smart suggestions to complete your diagram. Press Tab to accept these, making it quicker to build.

Auto-Naming and Descriptions

Capable AI can also suggest names and add descriptions to your diagrams, helping maintain clarity and consistency across your Confluence pages.

Screenshot 2024-10-24 at 15.27.46.png

Step 5: Insert the Diagram

  1. When you're satisfied with your Mermaid diagram, click Insert.

  2. The diagram will automatically appear within your Confluence page at the location of your cursor.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.