Documentation
Confluence Cloud
Please check out our YouTube video or our Live Demo to get an idea about how Mermaid Charts & Diagrams for Confluence (Cloud) works.
Installation
As any app for Confluence Cloud, you can install the app via the Confluence admin menu.
Log into your Confluence instance as an admin.
Click on โApps > Manage appsโ in the header menu.
Click on โFind new appsโ on the right navigation.
Search for โMermaid Charts & Diagrams for Confluenceโ and select it.
Click on โTry it freeโ to install the app.
Usage
Macros โMermaid diagramโ and "Mermaid diagram (Remote)"
Mermaid Charts & Diagrams for Confluence provides two macros called โMermaid diagramโ and "Mermaid diagram (Remote)" that can be added to any Confluence page. Both macros can be added by clicking the โInsertโ / โ+โ Button in the edit mode and selecting respective macro.
The macro โMermaid diagramโ allows you to define the textual description (referred as Mermaid code) of the chart or diagram you would like to show on the Confluence page whereas "Mermaid diagram (Remote)" enables you to load the Mermaid code from a remote location / URL or a Mermaid Live Editor URL. More information regarding the textual representation can be found in the official documentation of the Mermaid library the Confluence app is based on.
Moreover, both macros support the following customizing options:
Theme: Option to define how the diagram should be rendered (โDefaultโ automatically renders the diagram based on the users' current Confluence theme)
Look: Option to define the look of the rendered diagram ("hand drawn" is supported for flowcharts and state diagrams)
Allow download: Add a button to download the Mermaid diagram as image (PNG or SVG) or the Mermaid source code
Allow fullscreen: Add a button to show the Mermaid diagram in a fullscreen dialog
Allow copy to clipboard: Add a button to copy the Mermaid source code to the clipboard
Allow pan & zoom: Add buttons to pan and zoom (when viewing the Mermaid diagram)
Do not shrink to fit available width: Set Mermaid option โuseMaxWidth: falseโ if available for the diagram type
Height: Height in pixel that are used to render the macro (leave blank to use as much height as the diagram needs)
Zoom: Optional zoom factor to resize the rendered diagram (between 1 and 100)
Export width: Optional width for the Confluence PDF export in percentage (between 1 and 100)
The โMermaid diagramโ macro editor looks as follows:
The version dropdown in the top right corner of the macro editor allows you to switch between the last 20 versions of the diagram. An โUnsaved draftโ version is automatically added while editing the diagram, which allows you to always switch between previously saved versions and your work-in-progress. This "Unsaved draft" is lost when closing the editor without saving. Please note that this versions are managed โin parallelโ to the versions of the Confluence page the macro is placed on. In other words, every version of the Confluence page stores all diagram versions that existed at the time the Confluence page was created.
The โMermaid diagram (Remote)โ macro editor looks as follows and requires the option โURLโ to define the remote location of the Mermaid code:
Use the option โServer sideโ to load remote content from the server side to overcome CORS issues.
App configuration
As a Confluence administrator you can access the appโs global configuration page via the โConfigureโ button under โApps > Manage appsโ.
The app offers the following (global) settings which are applied to all Mermaid Charts & Diagrams for Confluence macros (in all spaces):
Data Protection Mode: If enabled, all data processing takes place only within the Atlassian cloud and within the user's browser. This is implemented by disabling those features where data processing on the appโs servers (managed by weweave) is required.
Hide โData Protection Modeโ errors in Confluence PDF exports: If enabled (only possible in combination with enabling โData Protection Modeโ), Confluence PDF exports do not include macros (errors). Instead, macros are just โskippedโ in exports.
Confluence Data Center & Confluence Server
Please check out our YouTube video to get an idea about how Mermaid Charts & Diagrams for Confluence (Data Center & Server) works.
Installation
As any app for Confluence Server or Confluence Data Center, you can install the app via the Confluence admin menu.
Log into your Confluence instance as an admin.
Click on โAdministration (cog icon) > Manage appsโ in the header menu.
Click on โFind new appsโ in the navigation.
Search for โMermaid Charts & Diagrams for Confluenceโ and select it.
Click on โTry trialโ to install the app.
Usage
Mermaid Charts & Diagrams for Confluence provides a macro called โMermaid Diagramโ that can be added to any Confluence page. The macro can be added by clicking the โ+โ Button in the edit mode and selecting the macro.
The Mermaid code can be added as macro body and the macro is rendered after publishing /updating the page.
Mermaid diagram configuration
When rendering the Mermaid code we automatically apply some Mermaid configurations for specific diagram types which are documented below.
Architecture diagram
The Iconify icon pack โlogosโ is included when rendering architecture diagrams and the icons are available under the prefix โlogosโ (see https://mermaid.js.org/syntax/architecture.html#icons).
Please note that icons included in icon packs are currently not supported when exporting the diagram (as image or Confluence page).