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

Docusaurus 3.1启用Mermaid遇默认导出错误,求正确配置方法

解决Docusaurus 3.1启用Mermaid时的“Only one default export allowed”错误

错误原因是你在docusaurus.config.js末尾新增了一个完整的export default配置块,导致一个JS模块里存在多个默认导出,违反了语法规则。正确操作是修改原有唯一的默认导出配置对象,而非新增。

具体步骤:

  • 打开docusaurus.config.js,找到文件中原本的export default { ... }代码块(这是文件里唯一的默认导出)。
  • 在该对象内,添加或修改markdown配置:
    markdown: {
      mermaid: true,
      // 保留原markdown配置(如果有)
    },
    
  • 同样在该对象内,找到themes数组,添加Mermaid主题:
    themes: [
      // 保留原主题(比如'@docusaurus/theme-classic')
      '@docusaurus/theme-mermaid'
    ],
    

修改后的完整配置示例(含基础默认配置):

export default {
  title: 'My Site',
  url: 'https://your-site-url.com',
  // 其他原有配置...

  markdown: {
    mermaid: true,
    // 其他markdown相关配置
  },

  themes: ['@docusaurus/theme-classic', '@docusaurus/theme-mermaid'],
};

注意:所有配置必须放在同一个export default对象中,不要新增第二个默认导出。如果原本没有markdown或themes属性,直接在对象内新增即可。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.30 02:52:09