Lakeboard Converter

io.github.FelixFangXPublished by GitHub account FelixFangXv0.5.0Updated Nov 4, 2026

Read Lakeboard and XMind as Markdown, JSON or outlines; build XMind files from Markdown.

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Converts local mind map files (Lakeboard, XMind, OPML, FreeMind, Markdown and more) to Markdown, JSON or outlines, and builds XMind files from Markdown.

What you can do
  • Convert a local mind map file to Markdown, JSON or outline text, choosing a sheet and a node cap
  • Batch-read 1 to 50 mind map files in one call, with per-file metadata
  • Inspect a map to get its format and topic counts without rendering content
  • Build an XMind file from a Markdown outline, either written to a path or returned as base64
When to use it
Useful when an assistant needs to read mind maps saved in Lakeboard, XMind, OPML, FreeMind, MindManager, iThoughts, SimpleMind or CSV outline formats, or to turn a Markdown outline into an XMind file for someone else to open.
Requirements
Runs as a local stdio process via npx (npm package lakeboard-converter) and needs Node.js 20.12 or newer. No accounts, API keys or environment variables are declared. Files are read from absolute local paths; for writing, the target folder must already exist.
Before you install
from_markdown writes a .xmind file to the path you pass and replaces an existing file only when overwrite is set, so check the path before allowing writes. Styles, layout, icons, relationships and encrypted nodes are not preserved, and MindNode packages must be exported to OPML first. Large maps are truncated at the node cap.

Installation

In SourceWeft

  1. Open Lakeboard Converter in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

[npm] [license]

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

markdown
# Launch plan- Alpha  > Ship the reader- [Docs](https://example.com/docs) `P1`
bash
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.

FormatRead → MarkdownWrite
OPML .opml, including MindNode OPML exportYes—
FreeMind and Freeplane .mmYes—
Markdown outline .md, .markdownYes. Headings, lists, markmap front matter, and indented outlinesXMind
Lakeboard .lakeboardYesXMind
XMind Zen and XMind 8 .xmindYesXMind
MindManager .mmapYes—
iThoughts .itmzYes—
SimpleMind .smmxYes—
CSV outline .csvYes. One topic per row; the column is the depth—

Not kept: styles, layout, icons, relationships, and encrypted nodes. 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.

bash
lakeboard-converter read ./map.opmllakeboard-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.

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.

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

License

MIT

Source: README.md at commit ebd0952

Tools

4

convert

Read a mind map

Pass an absolute path. Read a Yuque Lakeboard (.lakeboard) or XMind (.xmind) mind map from a local path. All sheets are included (each under its sheet title); pass sheet (1-based index or title) to read one. Large maps are cut at maxNodes (default 2000) and flagged as truncated. format "md" = nested Markdown list, "json" = topic tree, "outline" = compact indented text. Read-only.

ParameterspathrequiredsheetformatmaxDepthmaxNodes

convert_many

Read several mind maps

Read 1 to 50 local mind maps sequentially. Pass absolute paths. Content is returned in text; structuredContent contains per-file metadata only, without content. Node limits apply per file and across the batch. Read-only.

ParameterspathsrequiredsheetformatmaxDepthmaxNodesmaxTotalNodes

inspect

Check a mind map's size

Parse a local mind map and count topics without rendering content. Pass an absolute path. Read-only.

Parameterspathrequiredsheet

from_markdown

Build an XMind file from Markdown

Build an XMind file from a Markdown outline (headings and nested lists; links, `code` labels and > notes are kept). Pass an absolute .xmind output path to write the file (its folder must exist; an existing file is only replaced with overwrite: true), or omit output to get the file as base64 in structuredContent.base64. Nothing else is written. Large outlines are cut at maxNodes (default 2000) and flagged as truncated.

ParameterstitleoutputmarkdownrequiredmaxNodesoverwrite

Version history

3
  1. v0.5.0LatestOct 21, 2026
  2. v0.4.1Oct 19, 2026
  3. v0.4.0Oct 19, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts