这个起步模板建立在 Void Pages、React 适配器、Markdown 插件以及 Tailwind v4 之上。目标是让技术栈保持精简,同时依然让文档体验显得完整、有设计感。

请使用 Node.js 24.21.0 或更新版本。Void 相关包统一固定为 1.1.11,可从公开 npm 仓库安装,源码位于 voidzero-dev/void。

必要依赖

最重要的几块是:

  • void:负责文件路由和静态输出
  • @void/react:提供 React 页面支持
  • @void/md:负责 Markdown 渲染和元数据提取
  • @tailwindcss/vite 与 tailwindcss:负责样式

为什么 Markdown 是直接依赖

Markdown 支持是 Void 的可选 peer 依赖。这个起步模板直接安装 @void/md,让插件导入可以明确解析。

构建时流程

项目现在遵循一条很简单的流水线:

markdown 文件 -> 共享 docs 路由 -> Vite 构建 -> 预渲染静态输出

因为 void.config.ts 把 output 设成了 static,所以文档会在构建阶段直接渲染为 HTML,而不是等到运行时请求才生成。

对齐建议

当你更新某一个 Void 包时,最好把相关的几个一起更新。CLI、运行时插件、React 适配器以及 Markdown 插件在版本线保持一致时,通常协作得最好。

接下来可以阅读 部署,看看静态输出是如何发布的。