There are two ways to start a diagram on an issue.
From the Diagrams panel
- On an issue with no diagrams, pick New draw.io diagram, New Excalidraw whiteboard or New Mermaid diagram. Once the issue has diagrams, use New at the top of the panel.
- Draw your diagram in the full-screen editor.
- Press Save (or Ctrl+S). The diagram appears as a card in the panel.
From ••• → Diagrams, with a template
Open the issue's ••• menu and choose Diagrams. The Create diagram window shows a column for each editor, each with a blank option and a list of templates, plus up to six recent diagrams on the issue.
| Editor | Templates |
|---|---|
| draw.io | Process Flowchart, System Architecture |
| Excalidraw | Mind Map & Brainstorm, UI Wireframe |
| Mermaid | Sequence Diagram, ERD Database Model, Git Branch Graph |
Note: A new diagram is named after its template, or New Flowchart, New Whiteboard or New Mermaid Diagram when blank. Click the title in the editor to rename it.
Import a file
Use Import file in the Create diagram window, New → Import file… in the panel, or Import a file on an empty issue. The file is saved straight away and opened in the editor.
| Editor | Files you can import |
|---|---|
| draw.io | .drawio or .xml, or an .svg exported from draw.io with Include a copy of my diagram |
| Excalidraw | .excalidraw or .json |
| Mermaid | .mmd, .mermaid or .txt, or a Markdown (.md) file with a ```mermaid code block |