Markdown转流程图

具体问题

在技术文档编写中，经常需要描述流程、步骤或决策逻辑。纯 Markdown 文本虽然结构化，但在表达复杂流程时存在不足：

• 文本描述冗长，读者需要逐行解析逻辑
• 分支、循环或并行关系难以直观呈现
• 团队协作时，不同成员对流程理解可能不一致

技能如何工作

该技能通过自动化分析 Markdown 文档，将其转换为 Mermaid 流程图，核心流程如下：

1. 读取文档：接收用户提供的 .md 文件内容
2. 结构分析：识别文档中的关键元素，包括：

- 章节层级 (H1/H2/H3)
- 步骤顺序（数字编号、步骤词）
- 条件分支（如果/否则、是否）
- 依赖关系（需要、先要）
- 并行流程（同时）

1. 生成代码：基于分析结果，自动构建 Mermaid 流程图代码：

- 使用 flowchart TD/LR/BT/RL 定义主流程方向
- 节点采用中文描述，确保可读性
- 条件判断使用菱形节点，清晰区分分支

1. 输出结果：将 Mermaid 代码嵌入到新的 .md 文件中，直接可用

适用边界与注意点

该技能适用于多种文档类型，但需注意以下限制：

• 输入格式：仅支持标准 Markdown 文档，对非结构化文本效果有限
• 节点长度：建议节点描述不超过 20 字，以保持图表清晰
• 逻辑完整性：依赖文档本身的结构化程度，隐含逻辑可能无法自动识别
• 输出依赖：生成的流程图需要支持 Mermaid 的工具渲染，如 GitHub 或本地 Markdown 查看器

通过将文本流程可视化，该技能帮助开发者快速把握文档逻辑，适用于部署文档、API 文档、运维手册、README、教程、架构设计和项目管理等场景。