【实践出真知】使用Docusaurus将md文档组织起来就是一个网站（写API文档，写教程、写日记、写博客的有福了）

文章目录

前言
一、Docusaurus 是什么？
二、一键生成网站框架并预览
- 1. 系统需求
- 2. 脚手架项目网站（一键生成网站框架）
- 3. 生成的目录内容
- 4. 网站运行与展示
总结

前言

前段时间，学习Flet，访问到Flet中文网，被其简洁的风格吸引，就想着以后将自己的内容也整理一下。最终发现该网站是用Docusaurus这个工具实现的。以后写API文档，写教程、写日记、写博客有福了，只要写出markdown文档即可。现在包括csdn等很多平台都是md文档。这样移植也非常方便。下面就让我们来认识一下吧。

一、Docusaurus 是什么？

Docusaurus 官网：https://docusaurus.io/
Docusaurus 中文网简介：
⚡️ Docusaurus 能够帮助您快速创建一个精美的文档网站。

💸 定制一套技术栈是非常昂贵的。相反，Docusaurus 让您只需专注于内容，编写 Markdown 文件即可。

💥 准备好迎接更多功能了吗？还有版本控制、i18n、搜索和主题定制等高级功能。

💅 借鉴最好的 Docusaurus 网站以获取灵感；还有更多推荐您阅读的内容。

🧐 Docusaurus 是一款静态网站生成器。它利用 React 的全部功能来构建具有快速客户端导航功能的单页应用程序（single-page application），从而使您的网站具有交互性。它提供了开箱即用的文档功能，也可用于创建任何类型的网站（例如个人网站、产品展示、博客、营销落地页面等）。

二、一键生成网站框架并预览

1. 系统需求

安装Docusaurus需要Node.js，所以提前下载安装好。官方提示：
Node.js 18.0 或更高版本（可以通过执行 node -v 命令来查看当前所用的 Node.js 版本）。你可以使用 nvm 管理同一台计算机上安装的多个 Node 版本。
当安装 Node.js 时，建议选中与依赖项相关的所有复选框。

2. 脚手架项目网站（一键生成网站框架）

安装 Docusaurus 的最简单方法是使用命令行工具，该工具可帮助您搭建 Docusaurus 网站的雏形。您可以在新的空仓库中或已有的仓库中的运行此命令，它将创建一个包含脚手架文件的新目录。

npx create-docusaurus@latest my-website classic

my-website是你的网站目录名称，建议先转到自己的目录，然后再运行以上目录。

(base) C:\Users\Administrator>d:(base) D:\>cd pythonrun(base) D:\pythonrun>npx create-docusaurus@latest ktquant-doc classic
Need to install the following packages:
create-docusaurus@3.4.0
Ok to proceed? (y) y
npm WARN deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
√ Which language do you want to use? » JavaScript
[INFO] Creating new Docusaurus project...
[INFO] Installing dependencies with npm...
npm WARN deprecated inflight@1.0.6: This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.
npm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported
npm WARN deprecated rimraf@3.0.2: Rimraf versions prior to v4 are no longer supportedadded 1192 packages, and audited 1193 packages in 7m296 packages are looking for fundingrun `npm fund` for detailsfound 0 vulnerabilities
[SUCCESS] Created ktquant-doc.
[INFO] Inside that directory, you can run several commands:`npm start`Starts the development server.`npm run build`Bundles your website into static files for production.`npm run serve`Serves the built website locally.`npm run deploy`Publishes the website to GitHub pages.We recommend that you begin by typing:`cd ktquant-doc``npm start`Happy building awesome websites!npm notice
npm notice New major version of npm available! 9.8.1 -> 10.8.2
npm notice Changelog: https://github.com/npm/cli/releases/tag/v10.8.2
npm notice Run npm install -g npm@10.8.2 to update!
npm notice

3. 生成的目录内容

打开刚才指定的目录，即可看到对应的内容。
在这里插入图片描述
打开docs目录，可以看到有如下三个目录和文件，这就是以后网站将展示的内容：

4. 网站运行与展示

(base) D:\pythonrun>cd ktquant-doc(base) D:\pythonrun\ktquant-doc>npm run start> ktquant-doc@0.0.0 start
> docusaurus start[INFO] Starting the development server...
[SUCCESS] Docusaurus website is running at: http://localhost:3000/√ ClientCompiled successfully in 18.61sclient (webpack 5.93.0) compiled successfully