---
title: "PDF 导出中的分页符"
description: "了解在将 Tiptap 编辑器内容导出为 PDF 文件时的分页符支持。"
canonical_url: "https://tiptap.zhcndoc.com/conversion/export/pdf/page-breaks"
---

# PDF 导出中的分页符

了解在将 Tiptap 编辑器内容导出为 PDF 文件时的分页符支持。

- **1. 激活试用或订阅**

  在你的账户中开始[免费试用](https://cloud.tiptap.dev/v2?trial=true)或[订阅 Starter 计划](https://cloud.tiptap.dev/v2/billing)。
- **2. 从私有仓库安装**

  要安装此前端扩展，请按照[设置指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md)向 Tiptap 的私有 npm 仓库进行身份验证。

[PageBreak 扩展](https://tiptap.zhcndoc.com/pages/core-concepts/page-break-node.md)让用户可以在编辑器中插入显式的分页符。当与 PDF 导出扩展结合使用时，这些分页符会包含在导出的文档中。

## 工作原理

PDF 导出完全支持分页符。PDF 导出在底层使用 DOCX 转换，其中 `pageBreak` 节点会被转换为 `<w:br w:type="page"/>`，从而在生成的 PDF 中产生标准的分页符。

## Set up PageBreak and PDF export

Register the PageBreak extension together with the PDF export extension. Page breaks in the editor content will be automatically converted during export.

```ts
import { Editor } from '@tiptap/core'
import { ConvertKit } from '@tiptap-pro/extension-convert-kit'
import { ExportPdf } from '@tiptap-pro/extension-export-pdf'
import { PageBreak } from '@tiptap-pro/extension-pagebreak'

const editor = new Editor({
  extensions: [
    ConvertKit,
    PageBreak,
    ExportPdf.configure({
      token: 'your-jwt',
      onCompleteExport: (result) => {
        const blob = new Blob([result], { type: 'application/pdf' })
        const url = URL.createObjectURL(blob)
        const a = document.createElement('a')
        a.href = url
        a.download = 'export.pdf'
        a.click()
        URL.revokeObjectURL(url)
      },
    }),
  ],
})
```

## 了解更多

- [PageBreak 扩展参考](https://tiptap.zhcndoc.com/pages/core-concepts/page-break-node.md) 获取完整选项、命令和键盘快捷键
- [DOCX 导入中的分页符](https://tiptap.zhcndoc.com/conversion/import/docx/page-breaks.md) 获取导入支持
- [PDF 导出指南](https://tiptap.zhcndoc.com/conversion/export/pdf/editor-extension.md) 获取通用导出设置