1104 字
6 分钟
Web-to-PDF 使用指南:一键把网页保存成 PDF
最近整理资料时经常需要把网页内容交给 Gemini 阅读和分析,但浏览器自带“打印为 PDF”经常丢样式、截断页面或漏图片,影响后续识别。于是我写了一个 web-to-pdf 脚本:装上 Tampermonkey 后,在任意网页上点一下就能导出 PDF,支持快捷键、长页面优化和多种导出类型。
如果你经常做资料归档、阅读标注、长文保存,或需要把网页稳定转成文件再交给模型分析,这个脚本能让保存网页变得更可靠也更省心。
典型场景是:我把教程、文档、长文章打包成 PDF,再交给 Gemini 做要点提炼、对比分析或结构化笔记。只要导出的文件稳定、完整,后续分析结果也会更一致,这就是我做这个脚本的核心动机。
项目仓库:
https://github.com/GongyiChuren/web-to-pdf功能概览
- 支持所有网站:通用页面渲染逻辑
- 可拖动悬浮按钮:不挡内容,随手可点
- 快捷键操作:默认
Alt+U直接打开面板 - 自动适配页面尺寸:根据网页比例选择方向与大小
- 多种导出选项:PDF / 纯文本 / Markdown
- 长页面保护:自动缩放防截断,预加载懒加载图片
安装方式
先安装 Tampermonkey 扩展:
- Chrome / Edge:Tampermonkey 扩展商店
- Firefox:Tampermonkey 附加组件
然后安装脚本:
- 打开仓库里的
web-to-pdf-v2.user.js - Tampermonkey 会自动弹出安装页
- 点击“安装”
手动安装(粘贴脚本)
- 打开 Tampermonkey → “添加新脚本”
- 删除默认内容
- 粘贴
web-to-pdf-v2.user.js全部代码 - 保存后刷新网页即可使用
基本使用流程
- 打开任意网页
- 点击右下角 PDF 按钮
- 选择导出参数
- 点击“生成 PDF”
快捷键:按 Alt+U 可直接打开面板。
设置入口
面板右上角齿轮图标可以:
- 隐藏悬浮按钮
- 修改快捷键
导出选项说明
页面方向
- 自动检测:按页面宽高选择
- 纵向 / 横向:手动指定
页面格式
- 自适应:按实际页面大小
- A4 / A3 / Letter / Legal:标准纸张
捕获范围
- 主要内容:优先提取正文区域
- 整个页面:包含导航与侧栏
- 可见区域:仅当前屏幕
导出类型
- 纯文本(.txt)
- Markdown(.md) 选择文本类型时会导出文件,不生成 PDF。
图片质量
- 高质量:清晰度优先
- 标准:质量与体积平衡
- 压缩:体积优先
PDF 内嵌图片
- 生成前转成内嵌数据,减少缺失
- 会增加生成时间
简化样式(兼容模式)
- 移除导航、侧边栏、广告等干扰
- 适合样式复杂的网站
- 保留正文原始样式
自动缩放防截断
- 长页面自动降低渲染倍率
- 避免浏览器画布高度限制
预加载懒加载图片
- 自动滚动触发图片加载
- 降低图片缺失概率
常见问题与解决办法
生成失败或报错
优先尝试:
- 勾选“简化样式(兼容模式)”
- 捕获范围改为“主要内容”
- 降低图片质量或取消“包含图片”
PDF 截断 / 底部缺失
尝试:
- 勾选“自动缩放防截断”
- 勾选“预加载懒加载图片”
- 捕获范围改为“主要内容”
PDF 图片缺失或空白
尝试:
- 勾选“PDF 内嵌图片”
- 勾选“预加载懒加载图片”
- 等页面完全加载后再生成
按钮不显示 / 脚本不生效
检查:
- Tampermonkey 是否启用脚本
- 刷新或重开浏览器
- 网页是否有严格 CSP
- 设置里“显示悬浮按钮”是否开启
- 用
Alt+U直接唤起面板
更新记录(节选)
- v2.5.1:简化选项、导出类型改为下拉,面板支持滚动
- v2.2.0:自动缩放防截断、预加载懒加载图片
- v2.1.0:快捷键 + 设置面板
- v2.0.0:侧边栏 UI、可拖动按钮、自适应页面
结语
web-to-pdf 的目标是让“保存网页”变成一次点击就能完成的事。它适合长文收藏、资料归档、学习笔记,也能在样式复杂的页面里尽量保持完整度。后续我会继续优化兼容性和导出稳定性,有需求也欢迎提 Issue 或 PR。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!
Web-to-PDF 使用指南:一键把网页保存成 PDF
https://gongyichuren.github.io/posts/web-to-pdf/