Docusaurus

Docusaurus 是一个基于 React 和 Node.js 构建的静态网站生成器。它将您的 Markdown 文件转换为一个完整的文档网站，具备用户期望的所有功能。与从零开始构建网站不同，Docusaurus 为您处理了复杂的部分。

该工具使用 MDX，这意味着您可以在 Markdown 文件中直接添加交互式 React 组件，使您的文档更具吸引力且无需额外工作。它内置了由 Algolia 提供支持的搜索功能，支持不同产品版本的版本管理，并通过翻译工具支持超过70种语言。

由于它生成静态文件，您的文档加载速度快且可以托管在任何地方。网站在移动设备上表现出色，遵循现代网页速度和无障碍标准。

开始使用 Docusaurus 非常简单，只需几分钟：

• 在您的电脑上安装 Node.js 20 版本或更高版本，然后在终端运行设置命令以创建新站点。

• 在 docs 文件夹中使用 Markdown 文件编写文档。每个文件都会成为您网站上的一个页面。

• 通过编辑配置文件自定义外观。您可以更改颜色、添加徽标并设置导航菜单。

• 使用本地预览命令，在工作时即时在浏览器中查看更改效果。

• 通过在 blog 文件夹中创建带有日期的 Markdown 文件添加博客文章。

• 准备发布时，运行构建命令生成静态文件，然后将其上传到任何网络托管服务，如 GitHub Pages、Netlify 或 Vercel。

该工具包含详细的指南和一个有帮助的社区，供您遇到问题时参考。

• 免费且开源，采用MIT许可证

• 基于React和Node.js构建

• 使用Markdown和MDX编写内容

• 内置Algolia DocSearch搜索功能

• 支持产品版本管理

• 支持70多种语言

• 博客与文档合一的网站

• 暗黑模式与响应式设计

• 快速静态网站生成

• 轻松部署到任意主机