用MRXL命令行工具将Mermaid流程图转为可编辑Excel数据表

MRXL 是一个轻量级的命令行工具，它能够将 Mermaid 图表描述文件直接转换为结构化的 Excel (.xlsx) 文件。

• 输入：.mmd (Mermaid 文件)
• 输出：.xlsx (Excel 文件，包含结构化数据)
• 特点：基于 Go 语言开发，跨平台运行，提供独立的可执行文件。

核心能力

目前，MRXL 支持转换以下几种常见的 Mermaid 图表类型：

• 用户旅程图 (Journey)
• 饼图 (Pie)
• 四象限图 (Quadrant Chart)
• 时间轴 (Timeline)
• 序列图 (Sequence Diagram)

其核心价值在于：将图形化的 Mermaid 描述语言，一键转换为可供分析、编辑和存档的 Excel 表格数据。

转换流程可以概括为两步：

1. 解析：读取并理解 Mermaid 文件的语法结构。
2. 输出：将解析出的数据按逻辑组织，生成标准的 .xlsx 文件。

使用方式

使用非常简单，只需要一个命令。

mrxl -src input.mmd -out output.xlsx

执行后，工具会读取 input.mmd 文件，并生成一个名为 output.xlsx 的 Excel 文件。如果未指定输出文件名，默认会生成 mermaid.out.xlsx。

实际应用与效果展示

下面通过几个具体的例子，来看看 MRXL 的实际转换效果。

1. 序列图 (Sequence Diagram)

Mermaid 源码：

转换后的 Excel 效果：

2. 用户旅程图 (Journey)

Mermaid 源码：

journey
 section 使用产品
   登录: 3: 用户
   浏览: 5: 用户
   下单: 2: 用户

转换后的 Excel 效果：

3. 时间轴 (Timeline)

Mermaid 源码：

timeline
 2024 : 项目启动
 2025 : 开发阶段
 2026 : 上线

转换后的 Excel 效果：

4. 饼图 (Pie Chart)

Mermaid 源码：

pie
    title 利润贡献结构
    "高利润产品（软件+服务）" : 45
    "中利润产品（母排）" : 30
    "低利润产品（硬件销售）" : 20
    "亏损/战略投入" : 5

转换后的 Excel 效果：

5. 四象限图 (Quadrant Chart)

Mermaid 源码：

quadrantChart
    title Reach and Engagement of Campaigns
    x-axis Low Reach --> High Reach
    y-axis Low Engagement --> High Engagement
    quadrant-1 We should expand
    quadrant-2 Need to promote
    quadrant-3 Re-evaluate
    quadrant-4 May be improved
    Campaign A: [0.3, 0.6]
    Campaign B: [0.45, 0.23]
    Campaign C: [0.57, 0.69]
    Campaign D: [0.78, 0.34]
    Campaign E: [0.40, 0.34]
    Campaign F: [0.35, 0.78]

转换后的 Excel 效果：

为什么这个工具具有实用价值？

将“图表”自动转换为“可编辑数据”，在工程和协作场景中意义重大。它改变了图表的使用方式：

这种转变极大地提升了从图表中获取和利用信息的效率。

适合哪些人使用？

• 系统架构师/开发者：用于快速将系统流程、交互时序图转换为文档数据，方便评审和存档。
• 产品经理：轻松分析用户旅程图中的步骤与数据，进行定量评估。
• 项目经理：将项目时间轴、里程碑转换为表格，便于制作进度报告和资源规划。
• 数字化/自动化工程师：作为数据流水线的一环，将图形定义自动转化为下游分析系统可读取的数据格式。

总的来说，MRXL 是一款专注于解决特定场景需求的效率工具。它填补了从 Mermaid 图形化描述到 Excel 结构化数据之间的空白，尤其适合那些需要将设计图、规划图进行数据化管理和分析的团队。如果你对这类开源实战工具或如何制作清晰的技术文档感兴趣，欢迎在云栈社区交流讨论。