# 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.](https://help.gocapable.com/diagrams/create-and-insert.html)[Edit and updateChanging a diagram after it is on the page, recovering an old version, and what happens when two people edit at once.](https://help.gocapable.com/diagrams/edit-and-update.html)[Display and appearanceSizing, scaling, dark mode and making parts of a diagram clickable.](https://help.gocapable.com/diagrams/display-and-appearance.html)[Find and reuseFinding the diagrams you already have, and using one diagram on several pages.](https://help.gocapable.com/diagrams/find-and-reuse.html)[Shapes and iconsAdding your own shape libraries and icon sets so everyone draws with the same vocabulary.](https://help.gocapable.com/diagrams/shapes-and-icons.html)[ExportGetting a diagram out: as an image, or inside a PDF or Word export.](https://help.gocapable.com/diagrams/export.html)[Page and space graphsGenerated diagrams of how your Confluence pages link to each other.](https://help.gocapable.com/diagrams/page-and-space-graphs.html)[AI diagrammingDescribe a diagram in words and edit what comes back, in the editor or from chat.](https://help.gocapable.com/diagrams/ai-diagramming.html)[EditorsOne page per editing surface: draw.io, Excalidraw, BPMN, DMN, the text editor and the Mermaid visual editor.](https://help.gocapable.com/diagrams/editors.html)

---

## Related

[Diagram typesWhich editor suits which diagram.](https://help.gocapable.com/diagrams/diagram-types.html)

[ExamplesWorking source for every language.](https://help.gocapable.com/diagrams/examples.html)

[TroubleshootingWhen a diagram will not render or save.](https://help.gocapable.com/diagrams/troubleshooting.html)

---

_Pick the surface that suits the drawing, not the other way round._