# Embedding Mind Maps and Outlines

Mind maps and outlines can be embedded in your Markdown preview using Marked’s include syntax or the IA Writer block syntax. Behavior depends on the file format and the per-format checkboxes under Embed as Mermaid mind maps: in Marked Settings, Apps pane (Mind Maps and Outlines).

Contents

- Supported Formats
- Embed as Mermaid mind maps
- Include Syntax
- OPML Conversion
- Bike Conversion

## Supported Formats

### iThoughts X (.itmz)

iThoughts mind map files are zip archives containing map data and an optional preview image.

### MindManager (.mmap)

MindManager files are zip archives containing `Document.xml`. Unzipped MindManager packages (a folder containing `Document.xml`) and direct paths to `Document.xml` are also supported.

### FreeMind (.mm)

FreeMind mind map files use the `.mm` extension and store data as XML. Marked detects FreeMind format by checking that the file content starts with `<map`; if not (e.g., a code snippet), the file is included as plain text. FreeMind files are supported for Mermaid mind map embedding.

### OPML (.opml)

OPML (Outline Processor Markup Language) is an XML format for hierarchical outlines, widely used by outliners and feed readers. iThoughts and other apps can export to OPML. Marked converts included OPML files to Mermaid mind map diagrams.

### Bike (.bike)

Bike.app outlines are stored as proprietary HTML files (`.bike`). You can open a `.bike` file directly in Marked: the document is rendered as Markdown with the filename (minus extension) as the main heading (H1), top-level heading items as H2, nested headings as bold list items, and tasks as GitHub-style checkboxes. When a `.bike` file is included via include syntax, the Bike outlines checkbox under Embed as Mermaid mind maps: controls whether it becomes a Mermaid mind map (with the filename as the root node) or a nested Markdown list (no H1).

### OmniOutliner (.ooutline)

OmniOutliner outlines can be included the same way. The OmniOutliner outlines checkbox under Embed as Mermaid mind maps: controls Mermaid vs Markdown list rendering.

## Embed as Mermaid mind maps

In Marked Settings, Apps pane, under Mind Maps and Outlines, the group Embed as Mermaid mind maps: has one checkbox per format:

- Bike outlines
- Mind maps (iThoughts) (also covers FreeMind and MindManager)
- OPML files
- OmniOutliner outlines

When a format’s checkbox is enabled (the default for supported formats), Marked converts included files of that type to Mermaid diagrams:

iThoughts, MindManager, FreeMind, OPML, Bike & OmniOutliner — Rendered as Mermaid mindmap diagrams with the tidy-tree layout. For iThoughts and MindManager, shape information (rounded, rectangle, hexagon, etc.) is preserved where available. FreeMind (`.mm`) and OPML use the same mind map format. Bike (`.bike`) outlines use the included filename (minus extension) as the mind map root node. Node labels are plain text (links become link text; tasks show as ☐ / ☑ prefixes). Mermaid is included by default in every Markdown preview.

Limitation: Mind map embedding (Mermaid diagrams) does not work with the Discount parser. Use MultiMarkdown, CommonMark (GFM), or Kramdown for mind map previews.

When a format’s checkbox is disabled:

- iThoughts — The built-in preview image (`preview.png`) from the .itmz file is embedded as a base64 image. The image alt text uses the filename.
- MindManager — The outline is embedded as a nested Markdown list.
- FreeMind — The outline is embedded as a nested Markdown list.
- OPML — The outline is embedded as a nested Markdown list (no mind map).
- Bike — The outline is embedded as a nested Markdown list (no H1); top-level heading items become H2, nested headings are bold, and tasks become GitHub checkboxes.
- OmniOutliner — The outline is embedded as a nested Markdown list/checklist.

## Include Syntax

Use the same syntax as for other file includes:

    <<[path/to/map.itmz]
    <<[path/to/map.mmap]
    <<[path/to/map.mm]
    <<[path/to/outline.opml]
    <<[path/to/outline.bike]

Or with iA Writer block syntax:

    /path/to/map.itmz

Paths can be relative to the main document or absolute (starting with `/` or `~`). See Multi-File Documents for details.

## OPML Conversion

OPML files use nested `<outline>` elements with a `text` attribute. When OPML files is enabled under Embed as Mermaid mind maps: (see Settings: Apps), conversion produces a Mermaid mind map using the same format as iThoughts and MindManager:

- Child outlines of `<body>` become the top level (or children of an “Outline” root if there are multiple top-level items)
- Nested outlines define the hierarchy
- Missing or empty `text` is shown as `(unnamed)`
- Text is sanitized; special characters are escaped for Mermaid

## Bike Conversion

Bike `.bike` files are HTML with a root `<ul>` and `<li>` items. Items can have `data-type="heading"` (top level → H2 when opened or in list mode; nested → bold) or `data-type="task"` (GitHub checkboxes; completed when `data-done` has a timestamp, or `data-checked` / `data-completed` is true). Inline formatting and links in node text are converted to Markdown. When embedding as a Mermaid mind map, the file name (minus extension) is used as the single root node and labels are plain text formatted for Mermaid mindmap syntax.

#### Next up: Keyboard Shortcuts ▶

Support Site | Legal | Privacy