下标和上标
Beta
Subscript 和 superscript 标记可在 DOCX 与 Tiptap 之间往返转换。像 H₂O 这样的内容可以导入、在编辑器中渲染,并在导出回 DOCX 时保留格式。
你需要什么
- 扩展: ConvertKit 捆绑了
Subscript和Superscript,二者默认都已启用。 - 配置: 除了注册 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: 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)。