XMind转Markdown工具

简体中文 | English

一个基于浏览器的本地转换工具，可以将XMind文件（.xmind）转换为Markdown格式文件（.md）。 基于 XMind 23.08 Free 所支持的功能范围制作，且忽略概要、外框、图例、自由主题元素。 文件大小限制在50MB以内，数据在本地处理，保护您的隐私。

✨ 特性

• 支持单sheet和多sheet XMind文件
• 自动提取并管理图片资源
• 智能转换主题层级（H1-H6 + 列表嵌套，从第8级开始缩进）
• 支持链接、标签、备注等元素
• 纯本地处理，保护数据隐私
• 自动打包下载，方便分享
• 响应式设计，支持移动端

🚀 快速开始

使用方法

1. 直接在浏览器中打开index.html文件
2. 点击"选择XMind文件"按钮，选择.xmind文件
3. 点击"开始转换"按钮
4. 等待转换完成，工具会自动下载ZIP文件
5. 解压ZIP文件即可获得Markdown文件和资源文件

系统要求

• 操作系统：Windows、Linux
• 浏览器：Chrome（推荐使用最新版本）
• 文件大小限制：50MB以内

📁 项目结构

XmindToMarkdown/
├── index.html              # 主页面
├── css/
│   └── style.css          # 样式文件
├── js/
│   ├── app.js             # 应用入口
│   ├── ui-controller.js   # UI控制器
│   ├── file-handler.js    # 文件处理模块
│   ├── xmind-parser.js    # XMind解析模块
│   ├── markdown-generator.js  # Markdown生成模块
│   ├── resource-manager.js    # 资源管理模块
│   ├── conversion-manager.js  # 转换管理模块
│   ├── zip-packager.js    # ZIP打包模块
│   └── utils.js          # 工具函数
├── lib/
│   └── jszip.min.js      # JSZip库
├── 用户使用手册.md       # 用户文档
└── 技术文档.md          # 技术文档

🛠️ 技术栈

• 核心语言： JavaScript (ES6+)
• UI框架： 原生HTML/CSS
• 文件处理： JSZip 3.10.1
• 项目大小： ~1.5MB（含依赖库）

📊 支持的XMind元素

元素类型	支持情况	说明
主题层级	✅ 支持	1-6级转换为H1-H6，8级以上转换为列表嵌套
链接	✅ 支持	转换为Markdown链接格式，集成到标题中
标签	✅ 支持	转换为Lable:格式，特殊字符自动转义
图片	✅ 支持	保存至assets/目录，自动引用
备注	✅ 支持	转换为代码块格式，使用Notes语法定义
空主题	✅ 支持	空主题显示为"NULL"，保留所有元素
文件附件	❌ 不支持	仅支持图片附件，其他附件忽略
富文本样式	❌ 不支持	仅保留纯文本，样式信息不保留

📝 Markdown输出格式

文件命名规则

• 单sheet文件：生成与XMind文件同名的.md文件
• 多sheet文件：生成多个.md文件，命名格式为"文件名_序号.md"

主题层级转换

# 1级主题（H1）
## 2级主题（H2）
### 3级主题（H3）
#### 4级主题（H4）
##### 5级主题（H5）
###### 6级主题（H6）
- 7级主题（列表）
    - 8级主题（嵌套列表）

内容顺序

每个主题的内容按照以下顺序排列：

1. 文字内容（包含链接）
2. 标签（单独一行）
3. 图片
4. 备注（代码块）

示例：

# 中心主题
## [分支主题](https://example.com)
Lable:`标签1, 标签2`
![图片描述](assets/image.png)
```Notes
备注内容

## 📖 文档

- [用户使用手册](用户使用手册.md) - 详细的使用指南和常见问题
- [技术文档](技术文档.md) - 架构设计、API文档和开发指南

## 🔒 隐私说明

本工具基于XMind 23.08 Free所支持的功能范围制作，数据文件仅在本地转换处理，保护数据隐私。

- 所有文件处理均在浏览器本地完成
- 不会上传任何数据到服务器
- 不会收集任何用户信息
- 转换完成后可断网使用

## 📈 性能参考

| 文件大小 | 主题数量 | 图片数量 | 转换时间 |
|---------|---------|---------|---------|
| < 1MB | < 50 | < 10 | < 5秒 |
| 1-5MB | 50-200 | 10-30 | 5-15秒 |
| 5-10MB | 200-500 | 30-50 | 15-30秒 |
| 10-50MB | 500-1000 | 50-100 | 30-60秒 |

## ⚠️ 已知限制

- 仅支持图片附件，不支持其他类型附件
- 不支持富文本样式（加粗、斜体、颜色等）
- 不支持XMind的高级功能（公式、图表等）
- 文件大小限制为50MB
- 忽略概要、外框、自由主题元素

## 🤝 贡献

欢迎提交Issue和Pull Request！

## 📄 许可证

MIT License

## 📞 联系方式

如有问题或建议，请通过以下方式联系：

- 提交Issue到项目仓库
- 发送邮件至技术支持邮箱

---

**版本：** v1.1.3  
**最后更新：** 2026-01-14