lakeboard-converter

A mind map locked in one tool’s format is a dead end. This is the bridge from that file to Markdown, for agents and for people.

Convert a map — in the browser. The file stays on your machine.

# Launch plan
- Alpha
  > Ship the reader
- [Docs](https://example.com/docs) `P1`

npm install -g lakeboard-converter

lakeboard-converter read ./map.opml prints Markdown. The same command reads every format below. mindmap-converter is the same program. The package name stays lakeboard-converter.

Floating topics are kept. Relationships, summary topics, encrypted topic bodies, links that are not http/https/mailto, and notes with no plain text are reported in losses and on a > Note: line (see docs/conversion.md). Zip inputs are refused above 32 MiB compressed, 32 MiB inflated, or 1024 members. XMind Zen links are kept as stored. Styles, layout, and icons are omitted without a warning. MindManager notes are plain text. A CSV row with several topics is rejected. The native MindNode package is not read; export OPML.

English | 简体中文

Usage

Requires Node.js 20.12 or newer. convert does not replace an existing file unless you pass --overwrite. --format is md, xmind, or both (default both). --markdown-style is generic (default) or xmind.

lakeboard-converter read ./map.opml
lakeboard-converter build plan.md -o plan.xmind

lakeboard-converter with no subcommand opens the guided prompts.

read prints md (default), json, or outline. The default node cap is 2000 (--max-nodes, from 1 to 50000). The root is depth 0. Since 0.4.0, JSON for more than one sheet is { sheets: [{ index, title, root }] }. --sheet is a 1-based index or a sheet title. When a file omits structure the parser can see, read, inspect, and convert print > Note:. --json puts the same counts in losses.

The MCP tools are convert, convert_many, and inspect (read-only) and from_markdown (writes a .xmind only at the path you pass, in a folder that already exists). inspect reports the format in source. Set overwrite to replace a file. With no path, from_markdown returns the file as base64. Markdown input is capped at 2 MB. convert_many takes 1 to 50 files.

{
  "mcpServers": {
    "lakeboard-converter": {
      "command": "lakeboard-converter",
      "args": ["mcp"]
    }
  }
}

License

MIT