Mermaid 代码里的中文标点导致报错：哪些要换成半角？

一句话答案

Mermaid 的语法符号必须是半角（英文输入法下打出来的）：括号、冒号、分号、引号、箭头。节点文字里面的中文标点没问题。报错多半是因为表示形状或关系的那几个符号被打成了全角。

哪些符号要换

全角（会报错）	半角（正确）	用在哪
（ ） 【 】	( ) [ ]	节点形状
｛ ｝	{ }	判断菱形
：	:	时序图消息、甘特图任务
；	;	语句结尾
“ ”	"	包住带特殊字符的文字
－－＞ ——>	-->	连线

一个典型例子

下面这段有三处全角符号，渲染不出来：

flowchart TD
    A【提交申请】 --> B｛审核通过？｝
    B －－＞ C（完成）

换成半角后正常：

flowchart TD
    A[提交申请] --> B{审核通过？}
    B --> C(完成)

注意 审核通过？ 里的全角问号可以保留：它在花括号里面，属于文字。

看起来一样的连字符

AI 回复里的日期和样式有时用了「不换行连字符」，看着和 - 一样，其实是另一个字符：2026‑10‑01、stroke‑width。甘特图会报日期无效，流程图会报无法识别的字符。把它们重新打一遍半角 - 即可。

文字里就是要用括号怎么办

节点文字里需要出现半角括号或引号时，用双引号把整段文字包起来：

flowchart LR
    A["提交申请（含附件）"] --> B["审核 (1-3 个工作日)"]

不想逐个找

把代码或 AI 的整段回复粘贴进编辑器，全角括号、冒号、箭头和特殊连字符会被识别出来，状态行出现「一键修好」，点一下全部替换。每种报错的说明见常见报错。