一篇技术文档，最先被读到的不是观点。是标题、inline code、代码块和引用。复杂度大概是 。可以跳到 Next.js 文档 查细节。
我会先处理这些
- 标题锚点要稳定。
- 代码块要有语言名。
- 引用别像普通段落。
- 长表格别硬塞。
渲染检查表
| 元素 | 风险 | 处理 |
|---|---|---|
| 超链接 | 颜色太跳 | 用主题蓝色 |
| 图片 | 高度乱跳 | 固定比例 |
| 表格 | 移动端溢出 | 横向滚动 |
| 公式 | 像乱码 | 单独成块 |
const headings = tokens .filter((token) => token.type === "heading") .map((token) => ({ id: slugify(token.text), text: token.text, }));Markdown 不是纯文本。它是阅读节奏。