You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Docusaurus中Mermaid配置位置咨询:无法正常启用图表功能

Docusaurus启用Mermaid图表的配置位置问题

我是Docusaurus新手,正尝试在网站上启用Mermaid图表功能,按照官方文档操作时遇到困难。我的docusaurus.config.js结构如下:

const config = {
 ...
 presets: [
  ...
 ],

 themeConfig:
 ({
  ...
 }),

}

module.exports = config;

请问以下配置块应放在该结构中的哪个位置?

markdown: {
   mermaid: true,
 },
 themes: ['@docusaurus/theme-mermaid']

我已尝试将该配置块放在config.js的不同位置,但要么编译失败,要么编译成功但无Mermaid效果。


你需要把这两个配置项直接放在config对象的顶层,和presets、themeConfig同级,正确的配置结构如下:

const config = {
 ...
 presets: [
  ...
 ],

 themeConfig: ({
  ...
 }),

 // 新增的Mermaid配置
 markdown: {
   mermaid: true,
 },
 themes: ['@docusaurus/theme-mermaid']
}

module.exports = config;

额外注意:

  • 需先确保安装了依赖包,执行命令:npm install @docusaurus/theme-mermaid 或 yarn add @docusaurus/theme-mermaid
  • 配置完成后重启Docusaurus开发服务器,不要依赖热重载
  • 测试时在Markdown中使用Mermaid代码块,示例:
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

内容的提问来源于stack exchange,提问作者dargre

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.06 12:01:51