HTML5结构标签在PDF生成中基本无效，因PDF工具不解析语义，仅处理DOM与CSS；需依赖显式CSS（如break-before、bookmark-level）或工具专用语法实现排版与目录功能。
HTML5结构标签在PDF生成时基本无效，绝大多数工具只把它们当普通容器处理，不保留语义或自动应用样式。
为什么 <header></header>、<nav></nav>、<section></section> 在PDF里没反应
PDF不是浏览器，不解析HTML语义；主流转换工具（如 wkhtmltopdf、WeasyPrint、Puppeteer）默认只读取DOM结构和CSS，忽略元素的语义类型。比如 <article></article> 和 <div class="article"> 在渲染结果上完全等价。
<ul>
<li>wkhtmltopdf 0.12.x 及更早版本：完全无视HTML5标签，连基础样式都不识别</li>
<li>WeasyPrint 52+：能识别标签名，但仅用于CSS选择器匹配（如 <code>article { margin: 1em; }），不触发任何内置排版逻辑
想让PDF有章节结构？得靠显式CSS或工具专用标记
生成带目录、页眉页脚、分章的PDF，不能依赖HTML5标签本身，而要结合CSS或工具扩展语法。
- 用
@page和break-before: page控制分页：section { break-before: page; } - WeasyPrint 支持
bookmark-level生成PDF大纲：h1 { bookmark-level: 1; } section h2 { bookmark-level: 2; } - wkhtmltopdf 需通过
--outline参数 +<h1></h1>~<h6></h6>标签生成目录，<section></section>无作用 - Puppeteer 无法直接导出带书签的PDF，需先生成含
<h1></h1>的HTML，再用第三方库（如pdf-lib）注入大纲
兼容性陷阱：别在CSS里过度依赖HTML5标签选择器
某些旧版转换器对HTML5标签的CSS支持不完整，容易导致样式失效或布局错乱。
立即学习“前端免费学习笔记（深入）”；
- wkhtmltopdf 0.12.6 不支持
nav a:hover这类组合选择器中的HTML5标签名，必须写成div.nav a:hover并加class - 部分工具会把未知标签（如
<main></main>）当作内联元素处理，导致display: block不生效，需强制重置：main, article, section { display: block; } - 如果用CSS Grid/Flex布局配合
<header></header>，务必测试是否被转为块级——很多工具仍按 inline 渲染未知标签
真正起作用的是你写的CSS规则和工具接受的标记扩展，不是HTML5标签名字本身。别指望加个 <footer></footer> 就自动跑到每页底部，那得靠 @page :first { @bottom-center { content: "..." } } 或工具专属指令。
