Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

docs(mapping): record native superscript and subscript export

hugohe38e9813468302
diff --git a/docs/powerpoint-svg-mapping.md b/docs/powerpoint-svg-mapping.md
index 3a28182f..63311832 100644
--- a/docs/powerpoint-svg-mapping.md
+++ b/docs/powerpoint-svg-mapping.md
@@ -125,7 +125,7 @@ preset selection and authoring behavior are documented in
| Font size | Finite unitless SVG pixels, for example `font-size="24"` | DrawingML hundredths of a point; `1 px = 0.75 pt` | `Native-stable` after unit conversion | Generated authoring uses only unitless px; registered legacy units are compatible input and warn, while unknown units error; DrawingML minimum is 1 pt |
| Font weight | Registered `font-weight` on `<text>`/`<tspan>` | DrawingML regular/bold run switch | `Native-normalized`; numeric weights collapse to the DrawingML boolean boundary | The exact value grammar and aliases belong to [`svg-effects.md` §6.7](../skills/ppt-master/references/svg-effects.md#67-advanced-text-treatments) |
| Italic, underline, and strike | Registered `font-style` / `text-decoration` on `<text>`/`<tspan>` | DrawingML italic, underline, and strike run properties | `Native-stable` for registered tokens | Unknown tokens are rejected; the exact grammar belongs to [`svg-effects.md` §6.7](../skills/ppt-master/references/svg-effects.md#67-advanced-text-treatments) |
-| Superscript and subscript in ordinary text | No registered generated-SVG control; `baseline-shift` is invalid. Literal Unicode superscript/subscript glyphs and formula markers are separate authoring choices | The main generation route does not author `a:rPr@baseline` on ordinary runs | `Direct preservation` applies where a source-preserving native workflow leaves the owning text body intact; the SVG round-trip is `Native-stable` only through unchanged imported `txBody` metadata, and PPTX-to-SVG does not reconstruct the baseline shift in visible SVG | Structured mathematics uses editable OMML. A Unicode glyph remains literal text and does not become a native baseline shift |
+| Superscript and subscript in ordinary text | Exact direct `baseline-shift="super|sub"` on `<tspan>`; an explicit run `font-size` remains independent | Editable ordinary-text `a:rPr@baseline` at `30000` / `-25000`; no automatic font-size reduction | Forward export is native. PPTX-to-SVG does not reconstruct baseline shift in visible SVG; unchanged imported `txBody` metadata and source-preserving native workflows can still retain the source run | Inline style, other elements, numeric offsets, and combination with an inline formula marker are rejected; structured mathematics uses editable OMML, while a Unicode glyph remains literal text |
| Solid/gradient text fill and transparency | Canonical solid/gradient fill plus run alpha | DrawingML run fill and alpha | `Native-normalized` | Use the semantic alpha channel, not an unregistered CSS effect |
| Picture or texture text fill | `<text>` / non-positional `<tspan>` fill referencing one annotated single-image pattern | Editable DrawingML run `a:blipFill` with native stretch or tile | Forward export is native; stretch is `Native-normalized`, tile scale/phase may normalize; reverse import does not reconstruct the fill yet | Requires `data-pptx-text-image-fill="stretch|tile"`, one direct valid image, and no image clip/filter/mask/transform; see [`svg-effects.md` §6.3](../skills/ppt-master/references/svg-effects.md#63-gradients-and-paint-effects) |
| Text outline | Registered stroke on text | DrawingML run outline | `Native-normalized` | Review when outline carries fine visual meaning |
diff --git a/docs/zh/powerpoint-svg-mapping.md b/docs/zh/powerpoint-svg-mapping.md
index 4411983a..a61135b6 100644
--- a/docs/zh/powerpoint-svg-mapping.md
+++ b/docs/zh/powerpoint-svg-mapping.md
@@ -120,7 +120,7 @@ PowerPoint 意图
| 字号 | 有限、无单位的 SVG px,例如 `font-size="24"` | DrawingML 百分之一磅;`1 px = 0.75 pt` | 单位转换后为 `Native-stable` | 生成创作只使用无单位 px;已登记历史单位是会产生 warning 的兼容输入,未知单位为 error;DrawingML 下限为 1 pt |
| 字重 | `<text>`/`<tspan>` 上已登记的 `font-weight` | DrawingML 常规/粗体 run 开关 | `Native-normalized`;数值字重会折叠到 DrawingML 布尔边界 | 精确取值语法与别名属于 [`svg-effects.md` §6.7](../../skills/ppt-master/references/svg-effects.md#67-advanced-text-treatments) |
| 斜体、下划线与删除线 | `<text>`/`<tspan>` 上已登记的 `font-style` / `text-decoration` | DrawingML 斜体、下划线与删除线 run 属性 | 已登记 token 为 `Native-stable` | 拒绝未知 token;精确语法属于 [`svg-effects.md` §6.7](../../skills/ppt-master/references/svg-effects.md#67-advanced-text-treatments) |
-| 普通文本上标与下标 | 没有已登记的生成 SVG 控制;`baseline-shift` 为非法属性。Unicode 上下标字形与公式 marker 是另外两种创作选择 | 主生成路线不在普通 run 上创作 `a:rPr@baseline` | 源保留型原生工作流在不改所属文本体时为 `Direct preservation`;SVG 往返仅通过未修改的导入 `txBody` metadata 达到 `Native-stable`,PPTX-to-SVG 不在可见 SVG 中重建 baseline shift | 结构化数学使用可编辑 OMML;Unicode 字形仍是字面文字,不会变成原生 baseline shift |
+| 普通文本上标与下标 | `<tspan>` 上精确的直接属性 `baseline-shift="super|sub"`;显式 run `font-size` 与之独立 | 可编辑普通文本 `a:rPr@baseline`,取值为 `30000` / `-25000`;不会自动缩小字号 | 前向导出为原生能力。PPTX-to-SVG 不在可见 SVG 中重建 baseline shift;未修改的导入 `txBody` metadata 与源保留型原生工作流仍可保留来源 run | 拒绝 inline style、其他元素、数值偏移及与行内公式 marker 组合;结构化数学使用可编辑 OMML,Unicode 字形仍是字面文字 |
| 文本填充与透明度 | 规范 fill 加 run alpha | DrawingML run fill 与 alpha | `Native-normalized` | 使用语义 alpha 通道,不使用未登记 CSS 效果 |
| 文本轮廓 | 文本上已登记 stroke | DrawingML run outline | `Native-normalized` | 轮廓承载精细视觉意义时需复核 |
| 文本对齐 | 已登记的 `text-anchor` 与段落语义 | 段落对齐加归一化文本框位置 | `Native-normalized` | 不支持 run 级锚定与浏览器 baseline 启发式;精确放置属于 [`svg-effects.md` §6.7](../../skills/ppt-master/references/svg-effects.md#67-advanced-text-treatments) |