文档

嵌入 PDF 所需的一切。

三种使用 PDFembed 的方式：iframe 生成器（零配置）、URL 参数（精细控制）、以及自托管 JavaScript 库（高级定制）。

快速开始

在首页生成器中粘贴 PDF 链接，复制 iframe，粘贴到任意 HTML 中即可。

最小可用嵌入

<iframe src="https://pdfembed.com/embed/?url=https%3A%2F%2Fexample.com%2Freport.pdf" width="100%" height="600" style="border:0;border-radius:8px;overflow:hidden" allow="fullscreen" loading="lazy" title="PDF viewer"></iframe>

URL 参数

在查看器 URL 后追加参数，控制其外观与行为。

参数

类型

必填

说明

url

string

必填

PDF 的绝对 URL，需可被访客浏览器访问。

theme

auto | light | dark

可选

配色主题。`auto` 跟随访客系统设置，默认为 `auto`。

toolbar

0 | 1

可选

是否显示顶部工具栏，默认 `1`。

download

0 | 1

可选

是否显示下载按钮，默认 `1`。

page

整数 ≥ 1

可选

初始打开页码，默认 `1`。

各类框架

iframe 适用于所有平台。以下是几个便捷示例：

WordPress

[iframe src="https://pdfembed.com/embed/?url=YOUR_PDF" width="100%" height="600" style="border:0;border-radius:8px;overflow:hidden"]

Notion

将查看器 URL 粘贴到 /embed 模块中，Notion 会自动内联渲染。

Next.js / React

<iframe
  src={`https://pdfembed.com/embed/?url=${encodeURIComponent(pdfUrl)}`}
  width="100%"
  height="600"
  style={{ border: 0, borderRadius: 8, overflow: "hidden" }}
  allow="fullscreen"
  loading="lazy"
  title="PDF viewer"
/>

自托管

如果你希望查看器完全部署在自己的域名下——离线可用、品牌化、合规审计——可直接安装开源 EmbedPDF 库。

<div id="pdf"></div>
<script type="module">
  import { EmbedPDF } from "https://cdn.jsdelivr.net/npm/@embedpdf/core/dist/embedpdf.min.js";
  EmbedPDF.create({ target: "#pdf", url: "/path/to/your.pdf" });
</script>

安全与隐私

PDFembed 在客户端加载 PDF——我们看不到你的文件。托管查看器不发送遥测数据、不设置第三方 Cookie，且完全尊重你的源站访问控制。