---
title: "使用 .docx 导入自定义标记"
description: "了解如何使用我们的文档中的导入扩展从 DOCX（Word）文件中导入自定义标记。"
canonical_url: "https://tiptap.zhcndoc.com/conversion/import/docx/custom-mark-mapping"
---

# 使用 .docx 导入自定义标记

了解如何使用我们的文档中的导入扩展从 DOCX（Word）文件中导入自定义标记。

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

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

  要安装此前端扩展，请按照 [设置指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md) 登录 Tiptap 的私有 npm 注册表。

在导入 DOCX 文件时，您还可以定义如何将自定义标记转换回 Tiptap 节点。这是通过将自定义标记定义的数组传递给 `import` 命令来完成的。您可以使用此功能轻松地将 Word 中的自定义样式转换为 Tiptap。

```ts
import { ImportDocx } from '@tiptap-pro/extension-import-docx'

const editor = new Editor({
  extensions: [
    // 其他扩展 ...
    ImportDocx.configure({
      token: 'your-jwt',
      // 注意：仅用于演示目的
      endpoint: 'https://your-endpoint.com',
      imageUploadConfig: {
        url: 'https://your-endpoint.com/image-upload',
      },
      // ProseMirror 自定义标记映射
      prosemirrorMarks: {
        strong: 'bold',
        em: 'italic',
      }
    }),
    // 其他扩展 ...
  ],
  // 其他编辑器设置 ...
})
```

最新版本的 `@tiptap-pro/extension-import-docx` 提供了 `prosemirrorMarks` 配置选项。

此选项允许您将 DOCX 中的自定义节点映射到您的 Tiptap 架构。在上面的示例中，我们将 DOCX 中的 `strong` 和 `em` 节点映射到 Tiptap 架构中的 `bold` 和 `italic` 节点。

通过这样做，每当 DOCX 包含 `strong` 或 `em` 节点时，它将在导入时转换为 Tiptap 中的 `bold` 或 `italic` 节点。

> **DOCX、"prosemirrorNodes" 和 "prosemirrorMarks":**
>
> 请注意，`prosemirrorNodes` 和 `prosemirrorMarks` 选项仅在导入 `.docx` 文件时有效。如果您导入其他类型的文件，例如 `.odt` 文件，将使用 `/import` 端点而不是 `/import-docx` 端点，且 `prosemirrorNodes` 和 `prosemirrorMarks` 选项将不可用。