下标和上标

Beta

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

你需要什么

  • 扩展: ConvertKit 捆绑了 SubscriptSuperscript,二者默认都已启用。
  • 配置: 除了注册 ConvertKit 之外,不需要任何额外配置。

支持概览

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

导入

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

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

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

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

Editor Rendering

ConvertKit bundles both Subscript and Superscript and enables them by default, so no separate install is required.

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

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

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

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

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

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

当你设置 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)。