为网页而写：让技术文章更容易被读完
从段落节奏、视觉层级到代码示例的呈现方式，拆解一篇耐读技术文章应具备的关键结构。
为什么很多文章写得对，却读不完
当一篇文章的信息密度过高、层级不明确，读者会很快失去方向。网页阅读不是纸面阅读，用户随时可能被通知、标签页或滚动行为打断，因此一篇好文章首先要帮助读者“保持定位”。
三个常见问题
- 段落过长，核心句子不够突出
- 标题像目录，不像引导
- 示例代码有用，但和正文解释脱节
先设计阅读路径，再开始写作
我通常会先写出文章的二级标题，并确保每一节只回答一个问题。这样做有两个好处：
1. 读者能迅速扫到关心的部分
2. 写作者自己不容易跑题
一个简单的结构模板
you can think in sections, not in pages.
aim -> context -> solution -> tradeoff -> takeaway
代码示例为什么必须“可跳读”
代码高亮并不只是为了好看，而是为了帮助读者快速识别关键词、变量和结构。示例最好短小、完整，并在前后给出解释。
aim to keep snippets focused.
ts
export function formatDate(date: string) {
return new Intl.DateTimeFormat("zh-CN", {
year: "numeric",
month: "long",
day: "numeric",
}).format(new Date(date));
}
上面的函数只做一件事：把日期格式化为适合中文阅读的样式。短小明确的示例更容易被读者带走复用。
结语
如果你希望一篇文章真正被阅读，就不要只堆叠知识点，而要主动设计阅读体验。网页写作本质上也是界面设计。