Import brings content into the active tab from pasted text or a file. It is the counterpart to exporting: export a tab from one diagram, import it into a tab somewhere else.
Import formats
From the tab ellipsis menu, expand the Content section and choose Import, then pick a format:
- JSON reads a livediagram tab export (a
.livediagram-tab.jsonfile) and restores its elements exactly, the highest-fidelity round trip. - Mermaid reads a Mermaid flowchart (
graph/flowchart), state diagram (stateDiagram), or ER diagram (erDiagram) and lays it out on the canvas, keeping every connection, its style (dashed, thick, two-headed, headless),clicklinks, and anysubgraphor composite-state blocks, which come in as frames drawn around their nodes. Other Mermaid diagram types (sequence, gantt, pie, …) aren't supported. - Markdown turns a Markdown outline into a themed tree diagram, the same conversion as Markdown Import, so you can draft structure in text and bring it onto the canvas.
- Excalidraw reads a
.excalidrawscene (what excalidraw.com's Save to disk produces) and keeps its shapes, labels, arrow connections, groups, and freehand drawings. The hand-drawn look flattens to clean strokes, and embedded images come in as placeholders you can re-upload.
Because all four are text, each format opens the same two-step panel: paste or write the content into the editor and press Import, or press Import a file instead to pick one from disk. Either way the tab updates once it parses.
Import replaces the tab
Importing replaces the active tab's contents with what comes in, it does not merge. Because that is destructive, the dialog leads with a warning naming the tab about to be overwritten, so you can back out before committing. If you want to keep the current board, add a new tab first and import into that.
Import is unavailable while a tab is locked, since a locked tab is protected from edits.
Want to combine boards instead of replacing one? Import into a fresh tab, then copy the elements you want across to your working tab.
Was this article helpful?