模板地址: https://github.com/Inting124/vanilla_blog_template
特性
- Markdown 文章,front matter 驱动标题、日期、摘要和标签
- 按目录自动生成分类树,按标签生成标签页
- 文章列表分页(每页 10 篇,按日期倒序)
- 亮色 / 暗色 / 跟随系统
- 首页 Canvas 线框地球背景、移动端导航
- 文章页自动目录(二级、三级标题)
- esbuild 快速构建、Biome 检查、Node.js 原生测试
技术栈
| 语言 | TypeScript(strict) |
| 构建 | esbuild |
| 代码规范 | Biome |
| Markdown | marked |
| 测试 | node --test |
环境要求
- Node.js 20+
- npm,
package.json已开启"type": "module" - 运行
npm run test需要支持--experimental-strip-types的 Node.js(建议 22.6+)
使用此模板
- 在 GitHub 页面点击 Use this template,或把仓库克隆到本地
- 安装依赖并启动开发服务器
- 按下方的“自定义站点”修改站点信息
- 构建后部署生成的可部署副本
npm install
npm run dev
开发服务器地址会打印在终端。修改 public/ 或 model/ 后会自动重建。