PeakDevs

Limits

Size

A diagram can hold up to 100,000 characters of text, and a flowchart up to 2,000 links (arrows and lines). Past either, the macro shows "The diagram is too large to draw" with the limit and the numbers. Split the diagram into smaller ones, each in a macro of its own.

Big diagrams take time to draw in your browser. On our test machine a flowchart with 2,000 links took about 8 to 10 seconds, and a class diagram with 1,000 classes about 20 seconds. Sequence diagrams draw fastest.

Nothing from outside Confluence

The app loads nothing from outside Confluence: no images, fonts or styles from web addresses. So:

  • An image shape (img:) is refused with a message.
  • An image written into a label as HTML is removed from the drawing; the rest of the label draws.
  • A style that points at a file or a web address (url(…), image-set(…), @import) is refused with a message, also inside classDef, style or the diagram's settings.

This is how the app keeps its promise that diagram text sends nothing anywhere, even text that someone pasted in.

Not supported

  • Clickable links and click actions in diagrams. The app draws diagrams in Mermaid's strict security mode, which turns them off, so that text in a diagram can never run as a script.
  • Icon packs (for example for architecture diagrams). They would need to be loaded from outside.
  • Inside an expand: Confluence does not allow the macro there; the editor places it below the expand.
  • Diagrams in included pages (Include page and excerpts): an included page shows a placeholder, not the diagram.
  • A picture in Word export: Word shows the diagram text. See PDF and Word export.
  • Choosing a code block by position when a macro draws from the page: it always takes the nearest one. See Draw a code block that is already on the page.

Mermaid version

The app draws with Mermaid 12.3. How quickly a security fix in Mermaid reaches the app is in our security statement.

The diagram types are the ones that Mermaid version supports, such as flowcharts, sequence, class, state, entity relationship, Gantt, pie, mind map, timeline, Git graph and C4 diagrams.