Guides

One page per surface. Each covers the things people actually get stuck on rather than restating the toolbar.

#The editors

Surface	What it is for
draw.io	The full drawing tool: shape libraries, layers, connectors that stay attached.
Excalidraw	Fast, deliberately rough sketching for workshops and drafts.
Text editors	Mermaid, PlantUML, Graphviz and the rest. Write the diagram, get a picture.
BPMN and DMN	Proper process and decision modelling, validated against the standard.
The AI assistant	Describe the diagram in words and edit what it drafts.

#Everything in this section

Create and insertEvery way to get a diagram onto a page: draw it, import it, or point at one that already exists.Edit and updateChanging a diagram after it is on the page, recovering an old version, and what happens when two people edit at once.Display and appearanceSizing, scaling, dark mode and making parts of a diagram clickable.Find and reuseFinding the diagrams you already have, and using one diagram on several pages.Shapes and iconsAdding your own shape libraries and icon sets so everyone draws with the same vocabulary.ExportGetting a diagram out: as an image, or inside a PDF or Word export.Page and space graphsGenerated diagrams of how your Confluence pages link to each other.AI diagrammingDescribe a diagram in words and edit what comes back, in the editor or from chat.EditorsOne page per editing surface: draw.io, Excalidraw, BPMN, DMN, the text editor and the Mermaid visual editor.

Diagram types

Which editor suits which diagram.

Examples

Working source for every language.

Troubleshooting

When a diagram will not render or save.

Pick the surface that suits the drawing, not the other way round.