HTML 转 PDF v1.0

HTML 转 PDF 就是把一个网址或者一个 .html 文件渲染成 PDF 文档。DocPivot 的做法是调用无头 Chrome，通过 DevTools 协议下达指令，而不是把网页丢给办公套件去「导入」。和多数免费转换器最大的区别在于，它把「用多宽的屏幕来渲染这个页面」交给你决定——桌面 1280、宽屏 1920、平板 768、手机 390 四档，在页面开始加载之前就设定完毕。这一步几乎决定了响应式网站最后是按人眼看到的样子排版，还是塌成一条窄窄的手机栏。输出是文字可选中、可搜索的 PDF，不用注册，文件 30 分钟内自动删除。

为什么网页转成 PDF 之后常常「变成手机版」

网页转出来变窄、图片错位、两栏并成一栏，绝大多数情况不是转换器坏了，而是渲染时的视口宽度太小，触发了页面自己的响应式断点。现代网站用 CSS 媒体查询判断屏幕宽度，宽度低于某个数值（常见的是 768 px 或 1024 px）就自动切换成移动端布局。很多在线转换器把渲染窗口固定在一个偏窄的尺寸，于是网站「以为」自己正被手机访问，主动交出了移动版样式表。

还有第二层原因，很多人从来没意识到。浏览器打印时会切换到 print 媒体类型，网站为打印准备的样式表往往会隐藏侧边栏、放大字号、去掉背景色。如果转换器不做屏幕媒体模拟，即使视口设得再宽，打印那一刻还是会重新触发另一套规则，前面的设置等于白费。这个工具的处理顺序是先设视口、再模拟屏幕媒体、最后才导航加载，顺序颠倒过来就只能对已经选定样式表的页面做一次重排，救不回来。

顺序问题之外，引擎本身也有差别。不少免费工具至今用的是基于旧版 QtWebKit 的命令行渲染器，它多年缺乏维护，遇到 flexbox、CSS Grid、渐变背景经常直接放弃，中文字体缺失或者网页声明为 GB2312 编码时还容易出现方块和乱码。Chrome 的渲染结果和你在浏览器里看到的一致，中日韩字符的字形和字距也不会变形。如果你其实只需要正文文字、不在乎版式，那么直接用纯文本转 PDF反而比修一份排版失败的网页 PDF 省事。

工具概述：它做什么、给谁用

DocPivot 的网页转 PDF 属于服务端渲染，接受两种输入：粘贴的网址，或者上传的 .html 文件。粘贴网址时，系统会先解析并校验地址，每一次重定向跳转都重新检查一遍，因此工具无法被指向内网地址；上传文件则在本地暂存，并把纸张规则写进文件后再渲染。任务在队列中执行，每次都新建一个用完即毁的浏览器配置目录，不复用会话，不携带任何 Cookie。整个链路不调用第三方转换服务，也不需要 API 密钥。

用得最多的是三类人。做外贸独立站和跨境电商的运营，需要把 Shopify、WordPress 上的产品页整页存成 PDF 发给海外客户；前端和产品岗位，要把已经上线的页面交付给甲方或者归档到需求文档里；再就是需要留存网页内容的普通用户，比如订单确认页、报名结果页、知乎和 CSDN 上的长文。他们遇到的共同问题是：浏览器按 Ctrl+P 存出来的东西，广告、Cookie 提示条、「关注公众号」浮层全都印在上面，而且排版和屏幕上看到的对不上。DocPivot 把视口、纸张、边距、遮罩清理都变成可见的开关，转换前还能先看一眼预览。如果你要处理的是 Word、Excel、PPT 这类办公文件而不是网页，走Office 文档转 PDF那条路更合适。

主要优势

• 渲染宽度可选：四档视口由你指定，不是藏在后台的固定值。这一项对最终效果的影响，比纸张和边距加起来还大。
• Chrome 引擎渲染：渐变、flexbox、Grid、Web 字体都能正常呈现，不会被旧引擎降级成一堆错位的方块。
• 默认清掉遮罩：Cookie 同意条、订阅弹窗、悬浮客服按钮在打印前就被隐藏，不用你先手动删元素。
• 渲染真实页面：抓的是线上页面本身，页面自己的脚本会正常执行，懒加载的内容有机会加载出来。
• 转换前有预览：先用同一个引擎渲染一张实时截图给你看，确认没问题再转，省掉反复试错。
• 文字可搜索：输出的是带文本层的 PDF，可以复制、可以全文检索，不是一张图片拼起来的壳子。
• 适合长期归档：转好的文件如果要进档案系统，可以再走一道PDF/A 格式转换，符合长期保存的 ISO 标准。
• 可继续加工：产出的 PDF 是标准文件，需要放到网站上给人下载时，可以先做一次PDF 网页加载优化。

核心功能

• 网址转换：粘贴链接直接转，页面的脚本照常运行，动态渲染的内容不会丢空。
• 文件转换：上传本地 .html 文件，适合还没上线、只在本地能打开的页面。
• 四档视口：桌面 1280、宽屏 1920、平板 768、手机 390，对应四种完全不同的排版结果。
• 屏幕媒体模拟：强制按屏幕样式渲染，避免打印样式表在最后一刻把版面改掉。
• 纸张与方向：A4、Letter、Legal、A3，每种都可选纵向或横向，参数直接传给 Chrome 的打印接口。
• 一整页长图：不分页，测量整个文档高度后生成一张等高的单页 PDF，适合长图文和信息图。
• 边距四档：无边距、小、正常、大，桌面版式会按比例缩放到纸张上而不是被裁掉。
• 遮罩开关：Cookie 横幅可以选择隐藏或保留，做合规留证时保留反而更有用。
• 背景保留：可以保留或丢弃背景色和背景图，丢弃后打印更省墨，文件也更小。
• 页面裁切：如果转出来四周留白太多，用PDF 裁剪工具统一切一刀就行。
• 后续编号：多页文档需要页码时，交给PDF 添加页码处理，位置和字号都能选。
• 多页整合：几个页面分别转完之后，用PDF 合并工具拼成一份完整文档。

使用方法

1. 选择输入方式。粘贴网址，或者上传 .html 文件。能拿到网址就优先粘网址，原因见下文的限制说明。
2. 设定渲染宽度。这一步先做。想要 PDF 长得像电脑上打开的样子，选桌面 1280 或宽屏 1920。
3. 调纸张和边距。国内文档默认 A4 纵向，边距选正常；内容偏宽的仪表盘、后台截图页面改成横向更好看。
4. 决定要不要清遮罩。默认清掉 Cookie 弹窗和订阅浮层，如果你恰恰要留证这些提示，把开关拨到保留。
5. 看预览再转换。DocPivot 会先渲染一张实时截图，确认版面无误后再点转换，避免下载完才发现不对。
6. 下载与后处理。文件按来源命名，需要按章节拆开就用PDF 拆分工具再分一次。

渲染宽度该选哪一档

选宽度的原则很简单：你希望别人打开 PDF 时看到哪种版式，就选对应那一档。绝大多数网站的响应式断点集中在 768 px 和 1024 px 附近，跨过断点，导航栏、侧边栏、多栏布局的呈现方式会完全不同。

有个反直觉的点值得记住：手机 390 这一档不是「凑数」的。微信生态里的 H5 页面、公众号文章本身就是为窄屏设计的，用桌面宽度去渲染反而会拉出大片空白。同理，宽屏 1920 配 A4 纵向会把内容缩得很小，这时候要么换横向 A3，要么用PDF 多页合一在打印阶段重新排布。

什么时候该用这个工具

当你需要的是「页面当时的样子」，而不只是页面上的文字，网页转 PDF 才有意义。如果只要文字，复制粘贴到文档里更快；如果要的是可编辑的结构，转 PDF 反而是倒退。真正的使用场景基本都带着「留证」「交付」「离线」这三个词中的一个。

• 产品页交付：外贸独立站把产品详情页整页转成 PDF，随报价邮件发给海外买家。
• 订单留存：淘宝、京东、拼多多的订单确认页和退款页面存档，后续对账或者维权时有据可查。
• 报名结果存档：各类考试报名、政务办事的结果页，转成 PDF 比截图更完整，文字还能检索。
• 长文离线阅读：知乎回答、CSDN 教程、掘金文章转成 PDF，通勤时不用担心网络。
• 设计稿归档：前端把已上线页面按桌面宽度转出来，附在需求文档或者验收单里。
• 内容合规检查：小红书、抖音的落地页在投放前整页留底，方便和广告审核记录对照。
• 数据看板汇报：后台报表页面转成横向 PDF 进周报，比截图清晰得多；表格类数据也可以从源头走Excel 转 PDF。
• 培训材料整理：把在线课程页面和讲义整合成一份文件，配合PPT 转 PDF做成完整资料包。

四个真实场景怎么走

外贸独立站产品目录

背景：做家居用品出口的小团队，客户在邮件里要求发一份带图带价的产品说明，但网站只有网页版。

操作：逐个产品页粘贴网址，渲染宽度选桌面 1280，纸张 A4 纵向，保留背景以免商品图变成白底。四五个页面分别转完后合成一份，最后用PDF 添加水印打上公司标识再发出去。

效果：客户收到的是版式和网站一致的文档，图片和价格都在，不需要再问一遍规格。

项目验收单归档

背景：外包团队交付企业官网，甲方要求把上线后的每个页面截图入档，但截图不够清晰也不能检索。

操作：按桌面宽度逐页转换，Cookie 提示保留（因为验收要确认合规条提示已上线），生成的多页文档加上页眉页脚和日期，再由项目经理走一次PDF 电子签名确认。

效果：一份可全文搜索的验收材料，比一堆 PNG 截图更容易在两年后被找到。

投放素材留底

背景：信息流投放的 H5 落地页每两周换一版，广告平台事后抽查时要求提供当时的页面。

操作：渲染宽度选手机 390（落地页本来就是给手机看的），布局选「一整页长图」，得到一张不分页的长图 PDF，命名里带上日期。

效果：页面下线之后仍然有可核验的原貌记录，滚动阅读体验和手机上一致。

内部报表周更

背景：运营每周要把后台数据看板发到企业微信群，截图会被压缩得看不清数字。

操作：看板页面需要登录，所以先在本地另存为 .html 上传（或者由技术同事导出静态页），渲染宽度选宽屏 1920，纸张 A3 横向，边距选小。内含敏感客户名称的部分，转完后用PDF 密码保护加一层口令。

效果：数字清晰可读、可复制，群里的人不用再向后台要权限。

这个工具做不到的事

先说最容易踩的一条：上传的 .html 文件渲染出来一定比同一个页面用网址抓取要朴素得多。原因很直接，单个 HTML 文件到达服务器时，它引用的样式表、图片、字体都没有跟过来，浏览器只能用默认样式渲染裸结构。国内不少转换器在宣传页上写「完整保留原始布局」，对上传单文件这个场景来说并不成立。能拿到网址就粘网址，实在只有本地文件，也要接受结果偏素。

需要登录才能看的页面转不了。渲染是匿名进行的，不携带你的 Cookie，也不会替你输入账号密码，所以网银、企业后台、学信网内页这类内容，工具看到的只是登录框。这不是能力不足，是设计上刻意保持的边界——替用户保管会话凭据的服务，风险远大于便利。

Cookie 弹窗清理是启发式的，不是同意管理引擎。它按常见的元素名称匹配，也按形状判断（固定定位、面积大到足以遮住正文的元素会被隐藏），能覆盖绝大多数常见样式，但形态特别的遮罩仍然可能留在页面上。

还有几条硬性上限：上传文件不超过 100 MB，抓取页面的响应不超过 8 MB，重定向最多跟 4 跳，同一 IP 每小时有次数限制。「一整页长图」最长 200 英寸，这是 PDF 格式本身的天花板，不是工具的取舍。另外，网页里的 SVG 矢量图在渲染时会被光栅化处理，如果你要的是保真的矢量输出，请直接用SVG 转 PDF。

数据怎么处理，合规上要注意什么

转换在服务端完成，上传的文件和生成的结果都在 30 分钟内删除，每个任务用独立的浏览器配置目录，结束即销毁。这一点需要说清楚，因为它和「本地浏览器内处理」是两种模型：网页要被真实加载和渲染，这件事在浏览器里做不到隔离，必须有一台服务器去访问那个地址。DocPivot 的做法是把留存窗口压到最短，并且不复用任何会话状态。

从《个人信息保护法》和《数据安全法》的角度看，值得留意的是转换对象本身。订单页、报名结果页、后台报表这类页面往往包含姓名、手机号、身份证号、收货地址，属于个人信息；其中的行踪轨迹、金融账户信息还属于敏感个人信息。把这些页面转成 PDF 再转发出去，等于做了一次信息提供，处理的合法性基础要看你原本收集时的授权范围。实务上的建议是：转完之后先检查一遍，把不需要给对方看的字段用PDF 涂黑工具真正删掉，而不是画个黑框盖住——盖住的文字仍然能被复制出来。

另外提醒一句常被误解的事：网页转成的 PDF 本身不构成公证意义上的电子证据。它能证明「你在某时看到过这样一个页面」，但没有第三方时间戳和哈希存证，法律效力和司法区块链存证平台出具的记录不是一回事。真要维权取证，请走正规存证渠道，转换出来的 PDF 只能作为自己整理材料时的参考。

和常见免费转换器的差别

表里最后一行值得展开一句。命令行方式启动的 Chrome 无法指定纸张尺寸，只能用默认值，而 DevTools 协议可以把纸张、方向、边距、缩放作为真正的打印参数传下去。工具选择用 WebSocket 连协议、而不是简单调命令行，原因就在这里；命令行渲染只作为协议通道不可用时的备用路径保留。

常见问题