更新至 Docusaurus V3
按照官方文档将 Docusaurus 从 V2.4.3 升级至 V3.5.2,记录以下主要问题。
MDX 升级后的大量渲染报错
升级至 V3 版本需要升级 MDX 版本至 V3,升级后在渲染 mardown 文件时出现了大量报错,这是因为在新的 MDX 中默认将将 .md 文件也当作 .mdx 文件进行渲染了,在 docusaurus.config.js
中进行如下声明即可。
markdown:{
format: "detect"
},
升级后的数学公式渲染问题
If you use Docusaurus to render Math Equations, you should upgrade the MDX plugins.
Make sure to use
remark-math 6
andrehype-katex 7
for Docusaurus v3 (using MDX v3). We can't guarantee other versions will work.
Docusaurus 默认使用 katex
进行 LaTex 公式渲染,需要同步升级 remark-math 以及 rehype-katex。