---
title: "DOCX 导入中的分页符"
description: "了解如何使用 PageBreak 扩展在将 DOCX 文件导入 Tiptap 编辑器时保留分页符。"
canonical_url: "https://tiptap.zhcndoc.com/conversion/import/docx/page-breaks"
---

# DOCX 导入中的分页符

了解如何使用 PageBreak 扩展在将 DOCX 文件导入 Tiptap 编辑器时保留分页符。

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

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

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

导入包含分页符的 `.docx` 文件时，转换服务会在 Tiptap JSON 输出中发出 `pageBreak` 节点。要在编辑器中渲染并与这些分页符交互，请注册 `@tiptap-pro/extension-pagebreak` 扩展。

> **Interactive demo:** [PageBreak](https://embed-pro.tiptap.dev/preview/Extensions/PageBreak)

## 安装 PageBreak 扩展

```bash
npm install @tiptap-pro/extension-pagebreak
```

## 设置编辑器

在注册 Import 扩展的同时注册 PageBreak 扩展。导入时支持分页符不需要额外的配置。

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

const editor = new Editor({
  extensions: [
    ConvertKit,
    PageBreak,
    ImportDocx.configure({
      token: 'your-jwt',
      imageUploadConfig: {
        url: 'https://your-image-upload-endpoint.com',
      },
    }),
  ],
})
```

导入 `.docx` 文件时，文档中的任何分页符都会被保留为编辑器中的 `pageBreak` 节点。

```ts
editor.chain().focus().importDocx({ file }).run()
```

## 工作原理

1. 转换服务检测 `.docx` 文件中的分页符元素（`<w:br w:type="page"/>`）。
2. 每个分页符在 Tiptap JSON 输出中作为 `{ type: "pageBreak" }` 节点发出。
3. PageBreak 扩展将这些节点渲染为带有居中“分页符”标签的视觉虚线分隔符。

> **没有 PageBreak 扩展:**
>
> 如果未注册 PageBreak 扩展，导入的 `pageBreak` 节点需要一个[自定义扩展](https://tiptap.zhcndoc.com/editor/extensions/custom-extensions/extend-existing.md)来进行渲染。否则，编辑器 schema 将无法识别该节点类型。有关策略，请参阅[无效 schema 指南](https://tiptap.zhcndoc.com/guides/invalid-schema.md)。

## 了解更多

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