下标和上标
Beta
Subscript 和 superscript 标记可在 DOCX 与 Tiptap 之间往返转换。像 H₂O 这样的内容可以导入、在编辑器中渲染,并在导出回 DOCX 时保留格式。
你需要什么
- 扩展: ConvertKit —
Subscript和Superscript已捆绑并默认启用。 - 配置: 除了注册 ConvertKit 外,不需要其他配置。
支持概览
| 导入 | 编辑器 | 导出 | |
|---|---|---|---|
| Subscript | Supported | Supported via ConvertKit | Supported |
| Superscript | Supported | Supported via ConvertKit | Supported |
导入
使用 编辑器扩展 或 REST API 导入下标和上标。两者会产生完全相同的输出。
转换服务会读取 <w:vertAlign> 的运行属性,并生成相应的标记:
| Word 元素 | Tiptap 标记 |
|---|---|
<w:vertAlign val="subscript"> | subscript |
<w:vertAlign val="superscript"> | superscript |
化学式(H₂O、CO₂)、数学符号(x²、E=mc²)以及脚注引用都会正确导入。
编辑器渲染
ConvertKit 同时捆绑了 Subscript 和 Superscript,并默认启用它们——无需单独安装。
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: false 或 superscript: 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:sSub 和 m:sSup)。