在使用 VS Code 编写 Markdown 文档时,通过 `mermaid` 语法插入的流程图(如 `graph TD`)无法正常渲染,是常见问题。典型表现为预览中仅显示代码块,而非图形。此问题通常源于未安装支持 Mermaid 渲染的插件,或默认的 Markdown 预览器不支持该特性。即使安装了 Mermaid 插件,若配置不当或插件冲突,也可能导致渲染失败。此外,语法错误或缺少必要的 frontmatter 声明(如启用 mermaid 支持)也会阻止解析。需确认插件状态、检查语法规范,并确保使用兼容的预览工具,如 "Markdown Preview Enhanced" 或官方 Mermaid 支持扩展。
2条回答 默认 最新
独角鲸网络安全实验室 2025-11-28 10:31关注VS Code里Markdown的graph TD不渲染,按这几步来:
- 先装插件:要么装「Markdown Preview Enhanced」,要么微软官方的「Mermaid」插件,二选一就行,这是基础;
- 检查语法格式:代码块开头得写```mermaid,再跟graph TD,别漏了mermaid标识;
- 换预览方式:如果用的默认预览,切到装的插件预览(比如MPE的预览),有时候插件冲突就换一个;
- 重启试试:装完插件重启VS Code,偶尔没加载好也会这样。
简单说,先装对插件,再核对语法格式,基本就能显示了~
本回答被题主选为最佳回答 , 对您是否有帮助呢?解决 无用评论 打赏 举报