这个起步模板建立在 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 插件在版本线保持一致时,通常协作得最好。
接下来可以阅读 部署,看看静态输出是如何发布的。