技术教程演示文章
给没做完的东西留个位置
项目复盘的写作样例：写清尝试、取舍，也留下下一次要回答的问题。
本文为排版与功能演示，不代表站主真实经历。
从一份内容文件开始
这是验证多级目录、表格和链接的演示教程。它介绍一种内容整理方式，不是站主已经完成的真实项目记录。
分开内容与页面
文章标题、摘要和日期属于内容；排版、目录位置与页脚属于页面。把两者分开后，新增文章就不必修改页面组件。
最少需要哪些字段
| 字段 | 用途 | 示例规则 |
|---|---|---|
| title | 列表和阅读页标题 | 非空文本 |
| publishedAt | 排序与订阅日期 | 有效日期 |
| category | 内容分类 | 来自统一配置 |
| draft | 是否公开 | 草稿不生成公开路由 |
检查
先确认文章只出现在应当出现的地方：公开列表、首页最新内容和订阅源。草稿不应因为链接可猜测就被访问。
让目录来自真实标题
目录应使用 Markdown 处理器已经生成的标题 ID。自己按标题文字另造一套规则，会在重复标题或符号出现时产生偏差。
检查
这一节故意再次使用“检查”作为标题，验证目录能区分两个真实锚点。目录链接必须指向各自的标题，而不是都跳到第一个。
还要留意代码与长表格
长代码需要在自己的容器内横向滚动，不能把手机页面撑宽。复制动作应读到真正的代码文本，不能带上语言名称或按钮文案。
npm run check
npm run build留下下一步
- 用真实内容替换示例。
- 补上实际观察与验证结果。
- 保留尚未解决的问题，之后再继续。
如果需要了解文件与页面的联系，可以阅读 Astro 官方内容集合指南 ↗（新窗口打开）。这里的外链会明确提示在新窗口打开。