Mind maps in Confluence

A mind map spreads ideas around one central topic, branch by branch.

Last updated

When to use it

Use a mind map to collect and group ideas: a product strategy, a technology stack, the agenda of a workshop. The code is an indented list, so it is fast to type while people talk, and the diagram redraws at every line.

Example

This is the code of the Product strategy template: customers, problems, bets and metrics around one goal.

mindmap
  root((Product strategy))
    Customers
      Small teams
      Enterprise
    Problems
      Docs drift out of date
      Diagrams are hard to maintain
    Bets
      Code as source of truth
      Native Confluence experience
    Metrics
      Weekly active editors
      Retention after 30 days

Vellnar Diagrams draws it like this:

Change a line and the diagram changes with it. Nobody needs the original drawing file, because there is none: the code is the diagram.

Add it to a Confluence page

  1. Edit a Confluence page and type /mermaid where the diagram should go.
  2. Select Mermaid diagram. The editor opens with the template list.
  3. Pick a template, or choose Start blank and paste the code above. The preview follows every keystroke.
  4. Choose Save. The diagram appears on the page.

The documentation covers the editor, the settings and the exports.

Templates

The Templates button in the editor has 2 mind maps ready to use:

  • Product strategy: Customers, problems, bets and metrics around one goal.
  • Tech stack: Frontend, backend, platform and quality tools.

Syntax

The code of a mind map starts with mindmap. The Mermaid documentation describes every element of the syntax. Vellnar Diagrams draws it with Mermaid 12.3; if a line has an error, the editor marks the line and keeps the last valid diagram on screen.

More

  • Mermaid in Confluence: how diagrams as code work in a page, and every diagram type.
  • Security: the app asks for no permissions and sends nothing outside Atlassian.