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 附加组件

然后安装脚本:

  1. 打开仓库里的 web-to-pdf-v2.user.js
  2. Tampermonkey 会自动弹出安装页
  3. 点击“安装”

手动安装(粘贴脚本)#

  1. 打开 Tampermonkey → “添加新脚本”
  2. 删除默认内容
  3. 粘贴 web-to-pdf-v2.user.js 全部代码
  4. 保存后刷新网页即可使用

基本使用流程#

  1. 打开任意网页
  2. 点击右下角 PDF 按钮
  3. 选择导出参数
  4. 点击“生成 PDF”

快捷键:按 Alt+U 可直接打开面板。

设置入口#

面板右上角齿轮图标可以:

  • 隐藏悬浮按钮
  • 修改快捷键

导出选项说明#

页面方向

  • 自动检测:按页面宽高选择
  • 纵向 / 横向:手动指定

页面格式

  • 自适应:按实际页面大小
  • A4 / A3 / Letter / Legal:标准纸张

捕获范围

  • 主要内容:优先提取正文区域
  • 整个页面:包含导航与侧栏
  • 可见区域:仅当前屏幕

导出类型

  • PDF
  • 纯文本(.txt)
  • Markdown(.md) 选择文本类型时会导出文件,不生成 PDF。

图片质量

  • 高质量:清晰度优先
  • 标准:质量与体积平衡
  • 压缩:体积优先

PDF 内嵌图片

  • 生成前转成内嵌数据,减少缺失
  • 会增加生成时间

简化样式(兼容模式)

  • 移除导航、侧边栏、广告等干扰
  • 适合样式复杂的网站
  • 保留正文原始样式

自动缩放防截断

  • 长页面自动降低渲染倍率
  • 避免浏览器画布高度限制

预加载懒加载图片

  • 自动滚动触发图片加载
  • 降低图片缺失概率

常见问题与解决办法#

生成失败或报错

优先尝试:

  1. 勾选“简化样式(兼容模式)”
  2. 捕获范围改为“主要内容”
  3. 降低图片质量或取消“包含图片”

PDF 截断 / 底部缺失

尝试:

  1. 勾选“自动缩放防截断”
  2. 勾选“预加载懒加载图片”
  3. 捕获范围改为“主要内容”

PDF 图片缺失或空白

尝试:

  1. 勾选“PDF 内嵌图片”
  2. 勾选“预加载懒加载图片”
  3. 等页面完全加载后再生成

按钮不显示 / 脚本不生效

检查:

  1. Tampermonkey 是否启用脚本
  2. 刷新或重开浏览器
  3. 网页是否有严格 CSP
  4. 设置里“显示悬浮按钮”是否开启
  5. 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/
作者
GongyiChuren
发布于
2026-01-28
许可协议
CC BY-NC-SA 4.0

评论区

目录