HTML5结构标签在PDF生成中基本无效,因PDF工具不解析语义,仅处理DOM与CSS;需依赖显式CSS(如break-before、bookmark-level)或工具专用语法实现排版与目录功能。

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











