我们很高兴地宣布 Docusaurus 3.1 发布。

升级应该很容易：正如我们的 发布流程文档 中所解释的那样，次要版本遵循 语义化版本 。

今天，我们很高兴 宣布 Docusaurus 3.0 ！🥳

在 Meta 开源项目 , 我们相信 Docusaurus 将帮助您以 最小的努力 构建 最佳的文档网站 ，让您可以 专注于真正重要的事情 : 编写内容。

这是 Docusaurus 的一个新的 主要版本 ，它带来了 令人兴奋的新功能 和升级的依赖项。

根据 语义版本控制 原则，此版本包含我们在 v3 升级指南 中详尽记录的 重大更改 。重大更改可能会令人烦恼，但它们对于为我们计划实施的 新一波 Docusaurus 功能 奠定基础是必要的。

Docusaurus v3 ** 现在已 ** 进入测试阶段 ** ，正式发布即将到来。现在是开始 准备您的网站**以适应这个新的主要版本的好时机。

Docusaurus v3 带有一些 重大更改 ，其中许多可以在 Docusaurus v2 下处理 。提前准备您的网站可以逐步进行，并将使升级到 v3 更容易。

主要的重大更改是从 MDX v1 升级到 MDX v3。阅读 MDX v2 和 MDX v3 发行说明以了解详情。MDX 现在将更严格地编译您的 Markdown 内容，并存在细微的差异。

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

前端开发者经常需要 升级 npm 依赖 ，但这些升级可能会让人感到害怕，并导致常规测试套件无法捕获的 细微的 UI 副作用 。

升级 Docusaurus 就是一个很好的例子：如果不逐页检查，很难确定是否存在视觉回归。 Docusaurus v3 即将发布 （目前处于 测试阶段 ），我们希望帮助您充满信心地进行此升级。

本文介绍了一个基于 GitHub Actions 、 Playwright 和 Argos 的 视觉回归测试 工作流程。它没有直接与 Docusaurus 或 React 耦合，可以适应其他前端应用程序和框架。

我们很高兴地宣布 Docusaurus 2.4 发布。

升级应该很容易：正如我们的 发布流程文档 中所解释的那样，次要版本遵循 语义化版本 。