Docusaurus 3中Mermaid插件无法正常工作的问题求助

以下是几个排查和解决的关键点：

• 确保依赖正确安装
  @docusaurus/theme-mermaid需要单独安装，执行以下命令：

  npm install @docusaurus/theme-mermaid
  # 或使用yarn
  yarn add @docusaurus/theme-mermaid
  

• 检查Mermaid代码块语法
  必须在代码块开头指定mermaid标识，示例：

  flowchart LR
      A[Start] --> B{Is it?}
      B -->|Yes| C[OK]
      C --> D[End]
      B -->|No| E[Not OK]
      E --> D
  

  若代码块未标注mermaid，会被当作普通代码渲染。

• 清理缓存并重启服务
  缓存可能导致配置不生效，执行：

  npm run clear
  npm run start
  

• 排查插件/主题冲突
  暂时禁用其他第三方markdown插件或自定义主题，确认是否存在冲突。

• 验证Docusaurus版本
  确保使用的是最新的3.x版本：

  npm list @docusaurus/core
  

内容的提问来源于stack exchange，提问作者michaela šatarova