Markdown Import

Bring a Markdown outline into livediagram as a tidy, themed tree diagram.

Markdown import takes an outline written in Markdown and turns it into a real, editable diagram. It is built for the notes and mind maps you already have: an XMind export, an Obsidian or Logseq outline, or any file of headings and bullet points. The parser reads whatever hierarchy is actually in the file rather than expecting one fixed shape.

What it reads

Your document is treated as a hierarchical outline, and the importer is tolerant of how that hierarchy is expressed:

  • Headings (# to ######) nest by depth, so a deeper heading sits under the nearest shallower one.
  • List items (-, *, +, or numbered) nest by indentation, and attach under the heading above them. Task-list checkboxes are kept as their text.
  • Tables (pipe tables with a header row) become a table element.
  • Plain prose lines become leaf nodes so nothing is silently dropped.

Code blocks, horizontal rules, and blockquote markers are skipped, and inline formatting such as bold, italic, and links is flattened to plain text in the labels. If the file has a single top-level item it becomes the root; otherwise a root named from the file holds the top-level items so you always get one connected diagram.

What you get

The result is a tidy left-to-right tree: the root on the left, each level in its own column, children stacked and centred on their parent so nothing overlaps. Boxes are sized to their labels, deeper levels use smaller text, and parents connect to children with curved arrows. Any tables are placed in a column below the tree.

Everything is recoloured to a theme (the active tab's theme, or Brand as a fallback) and the new tab takes on that theme's background, so the import looks native rather than pasted in. It is ordinary elements afterwards, not a locked block, so you can rearrange and restyle it freely.

How to import

Open the Import… action from a tab's ellipsis (…) menu. The Import dialog opens, mirroring the Export dialog.

Choose Markdown as the format. This sets the file picker's filter and tells livediagram to build a tree.

Pick your .md file. The outline is built into the themed tree on that tab.

Import replaces the current tab's contents, including its elements, theme, and background, while keeping the tab's id and name. The dialog warns you before you commit. Because the replace is a single step, Undo (⌘Z) restores the previous contents if you change your mind.

Importing a .json tab export is also offered in the same dialog, restored exactly as it was saved. Pick the format that matches your file: livediagram does not guess.

Was this article helpful?