这个网站如何工作

这个网站使用 Notion 作为内容编辑和管理工具，通过 Notion API 获取内容，再由同步脚本转换成 VitePress 可以使用的 Markdown、路由和静态资源。

我平时主要在 Notion 中写作、整理和调整知识结构，不需要直接维护大量 Markdown 文件。

整体流程可以简单理解为：

Notion → 同步脚本 → VitePress → 静态网站

为什么这样做

我希望同时保留两件事：

• Notion 的编辑体验：方便写作、分类、排序和跨设备维护。
• 静态网站的可控性：拥有自己的 URL、导航、搜索、样式和部署方式。

所以这个项目里的分工大致是：

Notion = 编辑器 + CMS

同步脚本 = 内容编译器

VitePress = 展示层

Notion API 只在同步和构建阶段使用。访问网站时，用户看到的是 VitePress 已经生成好的静态页面，并不会直接请求 Notion。

同步脚本做了什么

同步脚本负责连接 Notion 和 VitePress。

它会读取 Notion 中的内容和目录结构，生成 Markdown、页面路由、Nav 和 Sidebar，同时处理图片、页面链接以及增量缓存等问题。

最终，我只需要继续在 Notion 中维护内容，构建时脚本会负责把这些内容转换成网站。