内容页模板怎么做：标题层级、目录、代码块与下一步行动

模板的作用是降低阅读成本，不是让每篇长得一样

内容页需要稳定的阅读规则：标题在哪、代码如何复制、警告长什么样、下一篇在哪里。稳定不等于机械套版。案例、比较、排错和操作教程应有不同正文结构，但基础排版与辅助信息要一致，这样读者不用每到一页重新学习界面。 先用一篇最长、代码最多的文章做压力测试。短文看起来正常，不代表真实内容不会撑破列宽、让表格横向溢出，或让浅色代码在深色背景上消失。

标题区先交代范围和适用条件

大标题要清楚但不应吞掉首屏。标题下面放一段真正的摘要：读者会完成什么、适用什么环境、哪些情况不包含。更新时间、作者、分类和预计阅读时间属于辅助信息，字号可以小，但颜色对比不能低到看不清。 不要在标题上方堆五六个徽章。标签是筛选信息，不是装饰。移动端中英文混排时允许自然换行，避免使用固定高度；长英文产品名和 URL 要设置可断行规则，不能把正文列撑出屏幕。

正文层级最多解决三层问题

页面只有一个 H1。正文用 H2 表示主要阶段，H3 表示阶段内的判断或步骤。若需要 H4 才能说清，通常应该拆段、列表或拆成另一篇文章。标题要表达结论或任务，如“先验证新会话再关闭密码登录”，比“安全设置”更能帮助扫读。 段落保持一个中心意思，中文正文行宽不要铺满超宽屏。桌面端约 32 到 40 个汉字一行更容易持续阅读；代码和表格可以临时突破正文宽度，但应在自己的容器内横向滚动。

目录服务长文，不服务形式

正文超过五个主要小节时再显示目录。目录只收录 H2，必要时展开当前 H2 下的少量 H3；把所有标题都列进去会比正文更难读。锚点要稳定，点击后标题不能被固定导航遮住，键盘焦点也应到达目标。 手机端目录可以折叠，但默认标题要说明“本页目录”，不能只放一个没有文字的图标。阅读到中部时，比悬浮目录更有价值的往往是清楚的小节标题和返回顶部入口。

代码块首先要保证看得见和复制正确

代码块至少包含语言标签、足够对比度、横向滚动和复制按钮。正文中的行内代码不能使用接近背景的颜色。深色主题最常见的错误，是语法高亮主题没加载，所有字符变成近乎白色或透明；验收时要关闭选中状态，直接观察普通显示。

sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy

命令前说明在哪台机器、以什么用户执行，命令后说明预期输出和失败怎么停。不要把密码、真实令牌和生产 IP 写进示例。多条命令需要逐步判断时分开代码块，避免读者一次粘贴整段，执行到一半才发现前一步失败。

风险提示要贴着动作出现

删除、覆盖、迁移数据库、收紧 SSH 和改 DNS 都需要就地警告。把所有注意事项集中到文章底部没有用，因为读者可能已经执行。提示应包括风险、执行前条件和撤销方式，而不只是一个红色“危险”标签。 表格用于精确比较，清单用于验收，引用用于说明来源，普通段落用于解释判断。不要把整篇文章塞进十几个同样的提示框；颜色过多会让真正的风险失去优先级。

结尾给出可验证的完成标准

技术文章不需要空泛总结。结尾列出三到五个可检查结果，再提供一个自然下一步。例如读者完成本文后，应能确认标题层级正确、移动端无横向溢出、代码可见可复制、风险提示靠近命令、前后篇链接有效。 资料来源放在正文判断附近或统一来源区，并保留访问时间；推广内容与编辑结论分开呈现。下一篇将用这套模板面对最容易出问题的窄屏场景：390px、触控与中文换行实操。