一句话答案
Mermaid 靠第一行判断你要画哪种图:flowchart TD、mindmap、sequenceDiagram、gantt 等。第一行不是这些关键字之一,就会报 No diagram type detected matching given configuration for text。在编辑器里这条报错显示为「没识别出图表类型」。
原因一:贴进来的是大纲,不是代码
向 AI 要思维导图时,它有时给的是带缩进或编号的文字大纲:
项目计划
需求调研
方案设计
开发测试
这本身不是 Mermaid 代码。在最前面加一行 mindmap,并把整体再缩进一级,就成了:
编辑器遇到这种带缩进、带编号或 Markdown 标题的大纲,会直接提示「转成思维导图」,点一下即可。
原因二:漏了首行
只复制了代码的后半段,或者 AI 自己就没写首行:
A[开始] --> B{通过?}
B -- 是 --> C[结束]
补上 flowchart TD 就能渲染:
原因三:首行拼错或用了别名
flowchart写成flowchat、flow chart,mindmap写成mind map、「思维导图」。- 雷达图要写
radar-beta,只写radar不认;鱼骨图要写ishikawa-beta,写fishbone不认。 - 首行前面混进了看不见的字符,或者
flowchart-TD里用了连字符(应为空格)。
这几种编辑器都能认出来,会给一个「一键修好」的按钮。
原因四:贴的是别的图表语言
digraph G { … } 是 Graphviz 的 DOT,@startuml … @enduml 是 PlantUML,它们和 Mermaid 不通用。把这段代码发给 AI,请它「改写成 Mermaid 代码」,再把回复整段贴回来。
手里只有一段文字描述
如果贴进来的是一段说明文字、网页内容或图片的描述,它确实不是代码。在编辑器里点「让 AI 画成图」,AI 会按内容整理成一张图;也可以照只有文字、没有代码那篇的写法自己向 AI 提问。其他报错的改法见常见报错。