下标和上标

Beta

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

你需要什么

  • 扩展: ConvertKitSubscriptSuperscript 已捆绑并默认启用。
  • 配置: 除了注册 ConvertKit 外,不需要其他配置。

支持概览

导入编辑器导出
SubscriptSupportedSupported via ConvertKitSupported
SuperscriptSupportedSupported via ConvertKitSupported

导入

使用 编辑器扩展REST API 导入下标和上标。两者会产生完全相同的输出。

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

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

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

编辑器渲染

ConvertKit 同时捆绑了 SubscriptSuperscript,并默认启用它们——无需单独安装。

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

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

下标会渲染为 <sub>,上标会渲染为 <sup>。键盘快捷键:下标为 Cmd+,上标为 Cmd+.。

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

ConvertKit.configure({
  subscript: false,   // 禁用下标
  superscript: false, // 禁用上标
})

禁用其中任意一个都会丢失导入的标记

当你设置 subscript: falsesuperscript: false 时,从导入的 DOCX 中得到的对应类型标记 将不会被编辑器 schema 识别。有关如何管理未识别标记,请参阅 无效 schema 指南

导出

编辑器扩展REST API 都会将 subscript 和 superscript 标记导出回 DOCX 的运行属性:

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

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

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