什么是drawio-generator
drawio-generator 是一个专为开发者设计的图表生成工具，能够根据 Mermaid、XML 或 CSV 格式的代码自动生成可交互的 draw.io 图表。用户只需提供相应的结构化代码，即可快速生成流程图、UML 图、ER 数据模型、网络拓扑图等多种类型的可视化图表。该工具的核心优势在于将文本描述自动转换为可在浏览器中直接打开和编辑的 draw.io 链接，极大提升了技术文档与架构设计的表达效率。无论是绘制简单的决策流程，还是构建复杂的系统架构图，drawio-generator 都能通过标准化的输入格式实现高效输出。 该工具支持三种主流输入格式：Mermaid 语法适用于大多数标准图表类型，如时序图、类图和实体关系图；CSV 格式则特别适合处理层级结构数据，例如组织架构图或依赖关系树；而 XML 格式作为 draw.io 的原生格式，提供了最精细的控制能力，允许用户对图形布局、样式、图标和自定义形状进行精确调整。每种格式都有其最佳使用场景，用户可根据具体需求选择合适的输入方式。 通过调用本地脚本 `generate_drawio_url.py`，用户可以将任意一段符合规范的代码转换为可直接分享的 markdown 链接。生成的链接指向一个在线的 draw.io 编辑器实例，用户不仅能查看图表，还能进一步编辑、导出为 PNG/SVG/PDF 等格式，或直接嵌入到 Markdown、Confluence 或 Notion 等文档系统中。整个过程无需安装额外软件，也无需手动操作图形界面，实现了从代码到可视化的无缝转换。
核心功能特点
- 支持 Mermaid、XML、CSV 三种输入格式，覆盖从简单流程图到复杂系统架构图的各类需求
- 自动将结构化代码转换为可交互的 draw.io 图表链接，支持在浏览器中实时编辑与导出
- 适用于多种图表类型，包括 UML 图、ERD、网络拓扑、BPMN 业务流程图及 UI 线框图等
- 提供命令行脚本接口，便于集成到自动化工作流或 CI/CD 流程中批量生成图表
- 生成的图表可直接嵌入 Markdown、Wiki 或文档平台，提升技术沟通与知识管理效率
适用场景
drawio-generator 特别适合需要频繁创建或维护技术图表的开发团队和产品经理。在日常工作中，当撰写 API 设计说明、系统架构文档或项目规划时，往往需要插入清晰的流程图或架构图来辅助理解。传统方式下，这些图表通常依赖图形化工具手动绘制，耗时且难以版本控制。而借助 drawio-generator，只需用 Mermaid 编写一段描述逻辑分支的代码，即可一键生成对应的可视化流程图，并嵌入到 GitBook 或 GitHub README 中，确保图文同步更新。 对于数据库建模人员而言，使用 Mermaid 语法可以快速定义实体关系图（ERD），清晰展示表之间的关联关系，避免因手绘草图导致的误解。而对于 DevOps 工程师来说，该工具能轻松生成 Kubernetes 集群部署图、AWS 云资源架构图或微服务调用链路图，帮助团队直观呈现基础设施状态。此外，在敏捷开发会议中，产品负责人可以用 CSV 格式导入组织结构变更数据，自动生成动态更新的 org chart，实时反映团队结构调整。 不仅如此，该工具还适用于教学场景。教师在讲解算法逻辑、状态机转换或软件设计模式时，可用 Mermaid 绘制序列图或活动图，让学生通过交互式图表加深理解。学生提交作业时也可用此工具生成规范的 UML 类图，提升作业的专业性与可读性。总之，任何需要将文本逻辑转化为可视化表达的场景，drawio-generator 都提供了一种轻量化、可编程且易于协作的解决方案。