跳到主要内容

教程简介

用不到 5 分钟的时间,快速认识 Docusaurus

快速开始

第一步:创建一个全新站点

或者直接使用 docusaurus.new 在线体验

准备工作

  • Node.js 20.0 及以上版本:
    • 安装 Node.js 时,建议勾选所有与依赖有关的选项,避免缺失组件。

生成新站点

使用 classic 模板创建一个新的 Docusaurus 站点。

运行以下命令后,classic 模板会自动添加到你的项目中:

npm init docusaurus@latest my-website classic

可以在命令提示符、PowerShell、Terminal,或你使用的任何代码编辑器内置终端中执行这条命令。

该命令会同时安装运行 Docusaurus 所需的全部依赖。

启动本地站点

先启动开发服务器:

cd my-website
npm run start

cd 用于切换当前终端目录。要操作刚创建的 Docusaurus 站点,需要先进入对应目录。

npm run start 会在本地构建网站并启动开发服务器,你可以在 http://localhost:3000/ 访问并预览。

打开本页 docs/intro.md,修改任意内容:站点会自动热更新并实时显示你的更改。