Importing a Tab

Bring a tab's contents in from pasted text or a file. Import a JSON tab, a Mermaid diagram, a Markdown outline, or an Excalidraw scene into the active tab.

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.json file) 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), click links, and any subgraph or 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 .excalidraw scene (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.

DraftImportExportJSON (.livediagram-tab.json)Markdown (outline)
The Content section of the tab menu opens Import, offering JSON, Mermaid, Markdown, and Excalidraw. Each opens a panel to paste the text or pick a file.

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.

Replace this tab?Importing overwritesDraft.CancelImport
Because importing overwrites the tab, the dialog warns you first and names the tab about to be replaced.

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?