这篇文章也作为写作参照：它覆盖了标题、摘要、提示块、表格、代码块、图片、折叠区域、任务清单、引用和链接等常用写法。

为什么换成 Docusaurus​

原来的 Halo 需要 Java 服务和 MySQL 数据库，资源占用相对高。当前服务器只有 2 核 CPU、3.8G 内存和 30G 磁盘，更适合托管静态站点。

Docusaurus 的优势：

• 内容直接写 Markdown。
• 构建后是静态文件，运行时内存占用低。
• 不需要数据库，备份更简单。
• 适合长期整理笔记、教程、项目文档和服务器维护记录。

这类“上线记录”适合放在 blog/ 目录；长期维护的命令清单更适合放在 docs/ 目录。

当前资源对比​

部署结构​

当前站点目录：

/root/docusaurus-notes

核心目录含义：

docusaurus-notes/
├── blog/      # 文章
├── docs/      # 笔记和文档
├── static/    # 静态资源，例如图片
├── build/     # 构建后的静态站点
└── package.json

发布命令​

每次修改文章或笔记后，执行：

cd /root/docusaurus-notes
npm run build
pm2 restart docusaurus-notes
pm2 save

也可以检查服务状态：

pm2 status
curl -I http://127.0.0.1:8090

Docusaurus 提示块​

折叠内容​

任务清单​

• 备份旧 Halo 数据
• 删除旧 Halo 和 MySQL
• 创建 Docusaurus 项目
• 配置 PM2 托管服务
• 发布示例笔记和文章
• 逐步整理历史笔记
• 设计站点分类和标签

图片写法​

公共图片可以放到：

static/img/

然后在 Markdown 中这样引用：

![图片说明](/img/docusaurus.png)

示例：

链接写法​

站内链接：

• 查看三维重建 6.1 笔记
• 查看 RoboLab 数据生成讨论笔记
• 查看文章列表

外部链接：

• Docusaurus 官方文档

后续计划​

接下来可以把这些内容整理进站点：

1. 服务器维护命令
2. Docker 和 PM2 常用操作
3. QQ 机器人部署记录
4. Docusaurus 写作规范
5. 常见故障排查

最后，给自己留一个简单规则：凡是以后可能重复用到的命令和流程，都写进笔记站。