跳到主要内容

一篇标记为“维护”的帖子

查看所有标签

为 Docusaurus v3 准备您的站点

·阅读约16分钟
Sébastien Lorber
Docusaurus 维护者,《本周 React》编辑
警告

这篇博文是在 Docusaurus v3 处于测试阶段时撰写的。如果您要升级到 Docusaurus v3 当前的稳定版本,请注意依赖版本和升级步骤方面的一些变化。请使用升级指南以获取最新的迁移步骤。

Docusaurus v3 现已进入测试阶段,正式发布也即将到来。现在是开始为您的网站做准备以迎接这个新的主版本号的绝佳时机。

Docusaurus v3 带来了一些重大变更,其中许多变更可以在 Docusaurus v2 下今天就开始处理。提前准备您的网站可以逐步进行,这将使升级到 v3 更加容易。

主要的不兼容性变化是从 MDX v1 升级到 MDX v3。请阅读MDX v2MDX v3发布说明了解详情。MDX 现在将更严格地并带来细微的差异来编译您的 Markdown 内容。

本文将主要关注如何为这个新的 MDX 版本准备您的内容,并列出一些您今天就可以处理的其他重大变更。

Preparing your site for Docusaurus v3 - social card