juejin.cn #新人报道# **标题：建议优化掘金 Markdown 编辑器的 Mermaid 流程图渲染功能**
掘金产品团队，你们好！
我经常使用掘金撰写 AI、大模型等技术文章，需要通过 Mermaid 绘制架构图和流程图。但在实际使用过程中，发现 Mermaid 渲染功能存在明显的兼容性问题，严重影响写作效率。
### 一、存在的问题
**1. 特殊字符被错误转义**
例如，原始 Mermaid 代码：
`A["输入 x"] --> B["输出 y"]`
经过编辑器处理后变成：
`A["输入 x"] --> B["输出 y"]`
双引号被自动转换为 HTML 实体，可能导致流程图无法正常渲染。
**2. Mermaid 语法兼容性较差**
在使用过程中发现：
- `flowchart TB` 等常见语法存在渲染失败的情况。
- 包含多个 `subgraph` 的流程图容易渲染失败。
- 部分流程图必须改成 `graph LR`，并删除复杂标签后才能正常显示。
- 同一段代码在其他 Mermaid 编辑器中可以正常渲染，但在掘金中无法使用。
**3. 缺乏有效的错误提示**
渲染失败时，无法快速判断是语法错误、版本问题还是编辑器预处理问题，只能反复修改代码进行排查。
### 二、优化建议
1. **修复 HTML 转义问题**：确保 Mermaid 代码在编辑、保存和预览过程中保持原始内容。
2. **升级 Mermaid 版本**：采用较新的稳定版本，完善对常见语法的支持。
3. **增加错误提示**：展示具体的解析错误、错误行号及原因。
4. **完善兼容性测试**：重点覆盖中文标签、特殊字符、复杂节点和多个子图等场景。
5. **公开 Mermaid 版本信息**：方便用户了解编辑器支持的语法范围。
### 三、期望效果
希望掘金能够尽可能兼容 Mermaid 官方语法，使开发者可以直接复用在 GitHub、VS Code、Mermaid Live Editor 等平台正常运行的流程图，而不需要专门针对掘金修改代码。
Markdown 和 Mermaid 是技术文章创作的重要工具，希望团队能够重视并改善相关体验。感谢！
