# 写作与发布指南

这个站点的内容全部是 Markdown 文件，放在 `content/` 目录下。改完文件跑构建命令即可发布（部署上线后是推送即自动发布）。

## 三种内容类型

| 类型 | 位置 | 说明 |
|---|---|---|
| 博文（post） | `content/blog/<分类>/<文章>.md` | 目录名即分类；生成列表、分类、标签、归档页 |
| 文档（doc） | `content/docs/**.md` | 自动进入侧边栏，带上一篇/下一篇 |
| 页面（page） | `content/*.md` | 独立页面，如关于页 |

## 基本流程

1. 新建 Markdown 文件（文件名建议直接用中文标题）。
2. 写 frontmatter：`title`、`description`、`tags`（可选）；日期和永久链接会由 `autoFrontmatter` 自动补全。
3. 本地预览：

```bash
pnpm run dev      # 开发预览（无搜索索引）
```

4. 提交前完整校验：

```bash
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」定位。