Mermaid 报 No diagram type detected 怎么办?

「No diagram type detected matching given configuration」的意思是第一行没有写图的类型。常见原因有四个:贴进来的是文字大纲不是代码、漏了首行、首行拼错、贴的是别的图表语言。每种都有对应的改法。

约 3 分钟更新于 2026-11-11

一句话答案

Mermaid 靠第一行判断你要画哪种图:flowchart TD、mindmap、sequenceDiagram、gantt 等。第一行不是这些关键字之一,就会报 No diagram type detected matching given configuration for text。在编辑器里这条报错显示为「没识别出图表类型」。

原因一:贴进来的是大纲,不是代码

向 AI 要思维导图时,它有时给的是带缩进或编号的文字大纲:

项目计划
  需求调研
  方案设计
  开发测试

这本身不是 Mermaid 代码。在最前面加一行 mindmap,并把整体再缩进一级,就成了:

mindmap
  项目计划
    需求调研
    方案设计
    开发测试

打开后可以改文字、换主题、下载 PNG / Word / PPT。

编辑器遇到这种带缩进、带编号或 Markdown 标题的大纲,会直接提示「转成思维导图」,点一下即可。

原因二:漏了首行

只复制了代码的后半段,或者 AI 自己就没写首行:

A[开始] --> B{通过?}
B -- 是 --> C[结束]

补上 flowchart TD 就能渲染:

flowchart TD
    A[开始] --> B{通过?}
    B -- 是 --> C[结束]

打开后可以改文字、换主题、下载 PNG / Word / PPT。

原因三:首行拼错或用了别名

  • 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 提问。其他报错的改法见常见报错。

其他教程

全部教程