报错参考 / flowchart, graph
某个节点 ID 在其形状之前包含了未加引号的空格,导致 Mermaid 把它读成了两条独立语句,而不是一个节点。
Parse error on line 2:
flowchart TD a b[Label] --> c[Next]
------------------^
Expecting 'SEMI', 'NEWLINE', 'EOF', 'AMP', 'START_LINK', 'LINK', 'LINK_ID', got 'NODE_STRING'裸节点 ID(形状如 [Label] 之前的标识符)不能包含空格——Mermaid 把空白当作语句分隔符。a b[Label] 会被解析成节点 a,后面跟着一个不相关的节点 b[Label],这在单独一行里是不合法的。
这很容易在不经意间触发:比如把一个描述性 ID 打成了 user profile,而不是 userProfile 或 user_profile。
节点 ID 要用一个不间断的整体 token——驼峰式、下划线或连字符都可以:userProfile[Label]、user_profile[Label]。把人类可读的文本放在形状的方括号里,而不是放进 ID。
解析失败
flowchart TD
a b[Label] --> c[Next]正常渲染
flowchart TD
a_b[Label] --> c[Next]