Docusaurus 2.0 已正式发布。

Docusaurus 是 Facebook（现更名为 Meta）开源的静态网站生成器。它将你的网站构建成一个单页面应用程序 (single-page application)，具有快速的客户端导航功能并充分利用了 React 的强大能力，为网站赋予更好地交互性。虽然 Docusaurus 是为文档功能而生的，但是也可以用来构建任何类型的网站（个人站点、产品介绍、博客、营销页面等）。

发布公告称，新一代的 Docusaurus 历经 4 年的开发，期间发布了 75 个 alpha 和 22 个 beta 版本。未来将会遵循语义化版本管理 (Semantic Versioning)，并更快地发布重大更新版本。

Docusaurus 2.0 主要变化

• React 既支持服务器端也支持客户端，可实现现代单页应用程序导航
• 提供深色主题、更好的 UI 和 UX
• 支持插件，插件使社区能够以第三方软件包的形式提供有用的功能
• 通过themeConfig 配置项可灵活更换主题
• 文档版本控制基于快照，并提供灵活的插件选项，以适应开发者工作流程
• TypeScript 支持配置文件、插件、自定义页面和主题作者
• Markdown 支持数学方程式、实时代码块
• 支持 PWA

在 Docusaurus 2 中，现在支持通过 MDX 在 Markdown 中插入 React 组件，轻松构建交互式文档。

示例：

docs/my-document.mdx

### Give it a try: press that button!

import ColorModeToggle from '@theme/ColorModeToggle';

<ColorModeToggle/>

虽然 Docusaurus 2 现在才正式发布，但它早已处于稳定状态，并被广泛使用，因此 Docusaurus 2 在 npm 的下载量很快就超过了 Docusaurus 1：

使用案例

• redocusaurus：与 OpenAPI 和 Redoc 无缝集成