Lakeboard Converter

io.github.FelixFangX由 GitHub 账号 FelixFangX 发布v0.5.0更新于 Nov 4, 2026

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

已验证STDIO仅桌面效率与工作流文件与存储

概览

AI 生成的概览

把本地思维导图文件(Lakeboard、XMind、OPML、FreeMind、Markdown 等)转换为 Markdown、JSON 或大纲,并能从 Markdown 生成 XMind 文件。

可以做什么
  • 将本地思维导图转换为 Markdown、JSON 或大纲文本,可选择工作表与节点上限
  • 一次批量读取 1 到 50 个思维导图文件,并返回每个文件的元数据
  • 检查导图,获取格式与主题数量而不渲染内容
  • 根据 Markdown 大纲生成 XMind 文件,可写入指定路径或以 base64 返回
适用场景
当助手需要读取以 Lakeboard、XMind、OPML、FreeMind、MindManager、iThoughts、SimpleMind 或 CSV 大纲格式保存的思维导图,或需要把 Markdown 大纲转成 XMind 文件交给他人打开时适用。
运行要求
通过 npx 以本地 stdio 进程运行(npm 包 lakeboard-converter),需要 Node.js 20.12 或更高版本。未声明任何账号、API 密钥或环境变量。读取使用本地绝对路径;写入时目标文件夹必须已存在。
安装前请注意
from_markdown 会向指定路径写入 .xmind 文件,仅在设置 overwrite 时覆盖已有文件,允许写入前请确认路径。样式、布局、图标、关系和加密节点不会被保留,MindNode 原生包需先导出为 OPML。大型导图会按节点上限被截断。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Lakeboard Converter,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源:README.md,提交 ebd0952

工具

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.

输入参数path必填sheetformatmaxDepthmaxNodes

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.

输入参数paths必填sheetformatmaxDepthmaxNodesmaxTotalNodes

inspect

Check a mind map's size

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

输入参数path必填sheet

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.

输入参数titleoutputmarkdown必填maxNodesoverwrite

版本历史

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

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分