section必须配h2~h6标题,否则语义失效、屏幕阅读器不可见、lighthouse报错;h1全页唯一,标题需层级递进且不可用p/div冒充;内容能独立命名并入大纲才适用section。

不用
section 必须带 <h2></h2>~<h6></h6>,否则语义失效
没标题的
-
<h1></h1>只能用一次,整个页面唯一;内部请从 <h2></h2>起始 - 标题可以视觉隐藏:
<h3 class="visually-hidden">技术参数</h3>完全合法 - 嵌套时必须层级递进:父
用 <h2></h2>,子用 <h3></h3>,不能全写<h2></h2> - 别用
<p></p>或<div>冒充标题——只有<code><h2></h2>~<h6></h6>能被解析为大纲节点什么内容该用 section,什么该用 div 或 nav
判断标准就一个:这块内容抽出来,能不能独立命名、被人引用、放进文档大纲?能,才轮到
出场。
Html To Pdf下载使用 Puppeteer + Chrome 将 HTML 渲染为中文 PDF,自动处理图表等待、Tab 展开、动画、测高、白边消除、防分页,适用于看板、报表、网页和交互图表转 PDF。
- 适合
: <h2></h2>性能对比+ 图表 + 数据说明;<h2></h2>部署步骤+ 代码块 + 注意事项 - 该用:轮播图控制按钮容器、仅为了加
margin的几个<p></p>、JS 绑定事件的临时包裹层- 该用
- 该用
:单篇博客、新闻稿、用户评论——它们可独立 RSS 抓取,不是“主题分组”而是“独立内容单元” 嵌套和同级使用时最容易踩的结构坑
结构失焦往往不是标签写错了,而是内容关系没理清。同级多个
不是排排坐,而是逻辑并列;嵌套不是越深越好,而是主题粒度是否合理。 - 同级
必须主题并列:比如 <h2></h2>背景介绍、<h2></h2>实现原理、<h2></h2>测试结果——不能混进<h2></h2>页脚版权 - 嵌套不宜超过两层:外层
<section><h2></h2></section>用户反馈,内层<section><h3></h3></section>正面评价,再往里就该考虑是不是该拆成独立或改用 - 列表
- 别用
包 - 整页只用一个
?相当于把整本书标成“第一章”,失去分区意义
真正难的不是怎么写
标签,而是写之前先问自己:这段内容,有没有资格出现在浏览器的文档大纲里?如果连名字都说不出来,那就老实用 。
- 适合










