Mermaid 思维导图渲染不出来的五个常见原因

一句话答案

Mermaid 的思维导图只靠缩进表示层级，规则很少但很严：只能有一个根、同级缩进要一致、文字里的括号会被当成形状。下面五种情况覆盖了绝大多数渲染失败。

一、有多个根节点

最外层只能有一行。两行都顶格，就是两个根：

mindmap
  复习计划
  考试安排

把第二个放到第一个下面，或者加一个总的根：

mindmap
  期末安排
    复习计划
    考试安排

二、缩进不一致

同一层的行要缩进一样多，子节点比父节点多缩进。空格和 Tab 混用最容易出问题，统一用空格。

mindmap
  读书笔记
    核心观点
      观点一
      观点二
    金句摘录
    行动清单

三、节点文字里有括号

名称(说明) 会被当成「id 加圆角形状」，括号不成对或嵌套就报错。把括号换成全角，或者用形状语法把整段文字包起来：

mindmap
  root((产品上线))
    市场调研（重点）
    ["竞品分析 (3 家)"]

四、用了思维导图不支持的写法

• 箭头 -->：思维导图没有连线，层级全靠缩进。
• classDef、style：思维导图不支持自定义样式语句，换主题来改颜色。
• 每行前面的 - 、* 、1. ：这是 Markdown 列表，不是 mindmap 语法，去掉。

五、写了两遍 mindmap

AI 有时把一张图分成两段输出，每段都以 mindmap 开头。一张图只能有一个 mindmap，把两段合到一个根下面。

让编辑器替你改

以上情况在思维导图页和编辑器里大多能自动识别：多余的列表符号、重复的 mindmap、文字里的括号会提示「一键修好」。完整的语法说明在思维导图语法，现成的结构可以从思维导图模板里挑。