这个站点的内容全部是 Markdown 文件，放在 content/ 目录下。改完文件跑构建命令即可发布（部署上线后是推送即自动发布）。
三种内容类型
| 类型 | 位置 | 说明 |
|---|---|---|
| 博文（post） | content/blog/<分类>/<文章>.md |
目录名即分类；生成列表、分类、标签、归档页 |
| 文档（doc） | content/docs/**.md |
自动进入侧边栏，带上一篇/下一篇 |
| 页面（page） | content/*.md |
独立页面，如关于页 |
基本流程
- 新建 Markdown 文件（文件名建议直接用中文标题）。
- 写 frontmatter：
title、description、tags（可选）；日期和永久链接会由autoFrontmatter自动补全。 - 本地预览：
pnpm run dev # 开发预览（无搜索索引）
- 提交前完整校验：
pnpm run validate # 类型检查 + 构建 + 搜索索引 + 链接审计
常用 Markdown 增强
- 提示块：
::: tip 内容 :::（还有 warning/danger 等） - 代码块自动语法高亮、复制按钮，超过 10 行自动显示行号
- 数学公式：
$E=mc^2$（KaTeX） - 图表：mermaid 代码围栏
更多能力见主题文档（本地 docs/archive/theme-default-readme.md 有主题原始说明的存档）。
约定
- 分类用中文目录名；标签用小写 kebab-case。
- 文档需要固定顺序时用数字前缀（如
1.入门.md，前缀会自动剥离）。 - 占位内容里的
TODO标记可以直接全文搜索「TODO」定位。