---
title: "下标和上标"
description: "下标和上标标记如何在 DOCX 和 Tiptap 之间往返转换。"
canonical_url: "https://tiptap.zhcndoc.com/conversion/content-types/text-and-formatting/subscript-superscript"
---

# 下标和上标

下标和上标标记如何在 DOCX 和 Tiptap 之间往返转换。

Subscript 和 superscript 标记可在 DOCX 与 Tiptap 之间往返转换。像 H₂O 这样的内容可以导入、在编辑器中渲染，并在导出回 DOCX 时保留格式。

## 你需要什么

- **扩展：** [ConvertKit](https://tiptap.zhcndoc.com/conversion/import/docx/convertkit.md) 捆绑了 `Subscript` 和 `Superscript`，二者默认都已启用。
- **配置：** 除了注册 ConvertKit 之外，不需要任何额外配置。

## 支持概览

|    | 导入 | 编辑器              | 导出 |
| -- | -- | ---------------- | -- |
| 下标 | 支持 | 通过 ConvertKit 支持 | 支持 |
| 上标 | 支持 | 通过 ConvertKit 支持 | 支持 |

## 导入

使用 [编辑器扩展](https://tiptap.zhcndoc.com/conversion/import/docx/editor-extension.md) 或 [REST API](https://tiptap.zhcndoc.com/conversion/import/docx/rest-api.md) 导入下标和上标。两者会产生完全相同的输出。

转换服务会读取 `<w:vertAlign>` 的运行属性，并生成相应的标记：

| Word 元素                           | Tiptap 标记     |
| --------------------------------- | ------------- |
| `<w:vertAlign val="subscript">`   | `subscript`   |
| `<w:vertAlign val="superscript">` | `superscript` |

化学式（H₂O、CO₂）、数学符号（x²、E=mc²）以及脚注引用都会正确导入。

## Editor Rendering

[ConvertKit](https://tiptap.zhcndoc.com/conversion/import/docx/convertkit.md) bundles both [`Subscript`](https://tiptap.zhcndoc.com/editor/extensions/marks/subscript.md) and [`Superscript`](https://tiptap.zhcndoc.com/editor/extensions/marks/superscript.md) and enables them by default, so no separate install is required.

```ts
import { ConvertKit } from '@tiptap-pro/extension-convert-kit'

const editor = new Editor({
  extensions: [ConvertKit],
})
```

下标会渲染为 `<sub>`，上标会渲染为 `<sup>`。键盘快捷键：下标为 Cmd+，上标为 Cmd+.。

如果你不想使用其中之一，可以通过 ConvertKit 的配置将其禁用：

```ts
ConvertKit.configure({
  subscript: false,   // Disable subscript
  superscript: false, // Disable superscript
})
```

> **禁用其中任意一个都会丢失导入的标记:**
>
> 当你设置 `subscript: false` 或 `superscript: false` 时，从导入的 DOCX 中得到的对应类型标记
> 将不会被编辑器 schema 识别。有关如何管理未识别标记，请参阅
> [无效 schema 指南](https://tiptap.zhcndoc.com/guides/invalid-schema.md)。

## 导出

[编辑器扩展](https://tiptap.zhcndoc.com/conversion/export/docx/editor-extension.md) 和 [REST API](https://tiptap.zhcndoc.com/conversion/export/docx/rest-api.md) 都会将 subscript 和 superscript 标记导出回 DOCX 的运行属性：

| Tiptap 标记     | Word 元素                           |
| ------------- | --------------------------------- |
| `subscript`   | `<w:vertAlign val="subscript">`   |
| `superscript` | `<w:vertAlign val="superscript">` |

化学式（H₂O、CO₂）、数学符号（x²、E=mc²）以及脚注引用都可以无损往返转换。

数学或 LaTeX 表达式中的下标和上标会遵循单独的代码路径（使用 OOXML 数学元素 `m:sSub` 和 `m:sSup`）。
