# 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.

---

## [#](#step-1-open-capable-diagrams-macro)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

![Insert Mermaid Diagram into Confluence](https://help.gocapable.com/images/8f65a684-b510-4ae1-ba75-483c572e3d60.webp)

---

## [#](#step-2-select-text-editor)Step 2: Select Text Editor

Choose the text editor option to view templates.

![Choose type of diagram to insert](https://help.gocapable.com/images/7da8a964-018f-41f5-b665-b0b3d59b65e7.webp)

---

## [#](#step-3-choose-from-a-template)Step 3: Choose from a template

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

![Choose from a diagram template](https://help.gocapable.com/images/9d084f29-f11a-4b97-b401-bdb96c4fc411.webp)

---

## [#](#step-4-add-your-mermaid-diagram-syntax)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)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)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)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)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.

![Use the mermaid editor in Confluence](https://help.gocapable.com/images/511ebb17-799a-4b49-93f0-f1dd22b5c804.webp)

---

## [#](#step-5-insert-the-diagram)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.