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
相关产品推荐
相关产品推荐

