, from the run/endParaRPr) or the
// line-height collapses to the container default. slide 4 的绿块用一段
// sz=3600 + 仅含 \t 的空段把编号顶到图标下方；按 .length>0 判它"非空"会丢掉
// 36pt 行高，编号塌回去压在图标上。用 trim() 把纯空白段也当空段处理。
const paraHasVisibleRuns = paragraph.runs.some(
(r) => r.text != null && r.text.trim().length > 0,
);
if (!paraHasVisibleRuns && paragraph.endParaRPr) {
const epSz = paragraph.endParaRPr.numAttr('sz');
if (epSz !== undefined) effectiveFontSize = epSz / 100;
}
if (!paraHasVisibleRuns) {
paraCssParts.push(`font-size: ${effectiveFontSize}pt`);
}
// CSS line-height places the extra leading (lineHeight − 1) × fontSize
// half above and half below the glyph, while PowerPoint pushes ALL of it
// above the first line — most visible on cover titles that use a large
// lnSpc value like 220% to create a deliberate gap between chapter number
// and the chapter title. Without the compensation, that "deliberate gap"
// ends up half its intended size in the browser. We only top up the
// missing half on unitless line-heights > 1; absolute spcPts already
// encode the exact line height and shouldn't be double-counted.
// Only top up the leading for paragraphs that actually have glyphs. An EMPTY
// (blank) paragraph is a pure spacer — PowerPoint reserves exactly lnSpc ×
// fontSize for it, with no extra half-leading above. Adding padding-top to
// blank lines over-reserves height; on decks that stack several blank
// paragraphs to push a bottom block down (slide 10 绿色提示条) the drift
// accumulates and the bottom text slips below its box.
if (
paraHasVisibleRuns &&
!merged.lineHeightAbsolute &&
/^[\d.]+$/.test(effectiveLineHeight)
) {
const lh = parseFloat(effectiveLineHeight);
if (lh > 1) {
const extraHalf = ((lh - 1) / 2) * effectiveFontSize;
if (extraHalf > 0.01) {
paraCssParts.push(`padding-top: ${extraHalf.toFixed(2)}pt`);
}
}
}
// 首段 spcBef / 末段 spcAft 仅在 bodyPr@spcFirstLastPara=1 时计入
const applySpaceBefore = !isFirstPara || spcFirstLastPara;
const applySpaceAfter = !isLastPara || spcFirstLastPara;
if (applySpaceBefore && merged.spaceBefore !== undefined && merged.spaceBefore !== 0) {
paraCssParts.push(`margin-top: ${merged.spaceBefore}pt`);
} else if (
applySpaceBefore &&
merged.spaceBeforePct !== undefined &&
merged.spaceBeforePct !== 0
) {
paraCssParts.push(`margin-top: ${merged.spaceBeforePct * effectiveFontSize}pt`);
}
if (applySpaceAfter && merged.spaceAfter !== undefined && merged.spaceAfter !== 0) {
paraCssParts.push(`margin-bottom: ${merged.spaceAfter}pt`);
} else if (
applySpaceAfter &&
merged.spaceAfterPct !== undefined &&
merged.spaceAfterPct !== 0
) {
paraCssParts.push(`margin-bottom: ${merged.spaceAfterPct * effectiveFontSize}pt`);
}
// ---- Bullets ----
// Suppress bullets for metadata placeholders (slide number, date, footer)
// Also suppress for empty paragraphs (no visible runs) — PowerPoint never shows bullets for them
const hasVisibleRuns = paragraph.runs.some((r) => r.text != null && r.text.length > 0);
const suppressBullet =
!hasVisibleRuns ||
placeholder?.type === 'sldNum' ||
placeholder?.type === 'dt' ||
placeholder?.type === 'ftr' ||
placeholder?.type === 'title' ||
placeholder?.type === 'ctrTitle' ||
placeholder?.type === 'subTitle';
let bulletPrefix = '';
if (!suppressBullet && merged.bulletNone !== true) {
if (merged.bulletChar) {
bulletPrefix = merged.bulletChar;
} else if (merged.bulletAutoNum) {
bulletPrefix = generateAutoNumber(merged.bulletAutoNum, bulletCounter);
bulletCounter++;
}
}
// When line spacing is absolute (spcPts), wrap each line in a block-level
// div with explicit height. This ensures exact spacing regardless of font
// metrics — CJK fonts (e.g. Microsoft YaHei) and bold faces often have
// ascent+descent larger than the spcPts value, which causes the browser
// to grow the line-box past the CSS line-height and silently overflow the
// text frame. Using a fixed-height div with overflow: visible keeps each
// line's layout footprint at exactly spcPts, matching PowerPoint behavior
// even for single-line paragraphs.
// tab-size 仅服务于折叠之后仍剩余的 tab（非行首 tab，少见）；行首 tab 已折进 margin-left。
const totalTabs = paragraph.runs.reduce(
(n, r) => n + (r.text ? (r.text.match(/\t/g)?.length ?? 0) : 0),
0,
);
if (totalTabs - leadingFoldedTabs > 0) {
paraCssParts.push(`tab-size: ${resolveTabPx().toFixed(2)}px`);
}
if (noWrap) {
paraCssParts.push('white-space: nowrap');
}
const useLineWrappers = !!(merged.lineHeightAbsolute && merged.lineHeight);
const paraCss = paraCssParts.join(';');
const openTag = useLineWrappers
? `
上 margin-left:marL + text-indent:indent // 已把首行起点定在 marL+indent；槽位只需补满到 marL，所以宽度是 |indent|。 // 若错用 marL：当真实 marL ≫ |indent|（如 slide 2「在集体中成长」右框 marL=78/indent=-30） // 时，过宽的槽把正文推到 marL+|indent| 之外、bullet 离正文很远。slide 3 那种「无显式 marL、 // 由 -indent 合成 marL」的情形 marL==|indent|，取值不变、不受影响。 const slotWidthPx = -(merged.textIndent ?? 0); // symbol bullet 的字形对齐： // - 合成 marL（无真实 marL、bullet 紧贴 element 左沿、可能压住相邻形状，如 slide 3 编号圆）： // 在槽内补 padding-left:16px 把 ■ 往右推、避开相邻形状光晕；body 位置不变。 // - 真实 marL：bullet 落在 marL+indent 的悬挂位（左对齐，无 padding），与 PPT 一致 // （slide 2 右框 ■ 实测落在 marL+indent，加 padding 反而把 ■ 顶到正文上）。 const symbolSlotPad = marginLeftSynthesized ? 'padding-left:16px;box-sizing:border-box;' : 'box-sizing:border-box;'; // 普通 list bullet（•/◦ 等非 symbol-font 字形）在槽位内靠右、贴近正文， // 留一个 0.4em 的小间距，续行左缩进不变、仍与首行正文对齐。 const slotPad = isSymbolBullet ? symbolSlotPad : 'text-align:right;padding-right:0.4em;box-sizing:border-box;'; // text-indent:0 — hanging-indent 段在
上带 `text-indent:-N`，而 CSS text-indent // 会被 display:inline-block 的槽位 span 当作块级容器继承，把槽内 bullet 字形再左移 N， // 落到 element 左外（slide 3 的 ■ 飞到左侧编号圆上）。在槽位上显式归零切断继承，bullet // 字形稳定落在 padding 处，body 与续行仍由
的 margin-left/text-indent 控制不受影响。 bulletHtml = `${escapeHtml(displayChar)}`; } else { bulletHtml = `${escapeHtml(displayChar)} `; } } let currentLineDivOpen = false; const openLineWrapper = () => { if (!useLineWrappers || !merged.lineHeight) return; // Fixed `height` (not min-height) pins each line to exactly spcPts — the // PowerPoint line pitch — regardless of the font's content area. CJK faces // (self-hosted SourceHanSerif/Sans) report a content area noticeably taller // than spcPts (e.g. 15pt glyphs ≈ 30px vs a 19.15pt≈25.5px pitch); with // `min-height` Chrome grows the line box to that content area, so every // absolute-spaced line is a few px too tall. Stacked over a column the drift // pushes bottom blocks down — e.g. 后勤 slide 10/11 绿色提示框文字下溢/未居中。 // Trade-off: a single logical paragraph whose text SOFT-wraps to >1 visual // line will overflow this fixed-height box (overlapping the next paragraph), // since one wrapper == one logical line. Explicit line breaks are safe (each // `\n` opens its own wrapper). Acceptable here: absolute-spaced paragraphs in // these decks are single-line; matching the line pitch matters more. // min-height(而非 height)：固定 height 能精确还原 PPT 行距，但被就地编辑(增删行)后 // 无法 reflow——多出的行 overflow 到盒外，且"实时编辑态"与"保存→重解析态"对不齐。 // a2m 是编辑器，编辑一致性优先：改用 min-height，编辑增删行时盒子能撑高、两态一致。 // 代价：CJK 字体内容区略高于 spcPts 时单行可能高几 px（行距漂移），由回归把关。 html += `
path: bullet first, then a blank-line filler for an otherwise
// empty paragraph. Use (NOT
): a trailing
renders as 1 line
// in raw-HTML renderers, but a2m 的 ProseMirror 会在末尾 hard_break 后再补一个
// trailingBreak（
）→ 空段变成 2 行，累积把下方正文/图标整体压下去
// （图标与行错位、绿框文字被挤出）。 在两端都恰好是 1 行
// （高度 = font-size × line-height），不会被 ProseMirror 加倍。
html += bulletHtml;
// Blank-line filler: an empty
reserves NO height (height 0) regardless
// of font-size/line-height — it needs an inline box. Emit whenever
// the paragraph has no VISIBLE runs, which now also covers whitespace-only
// spacer paragraphs whose tab/space runs get stripped by the leading fold
// (slide 4 绿块的 sz=3600 空段：少了 就塌成 0 高，编号顶回图标上)。
if (!paraHasVisibleRuns) {
html += ' ';
}
}
// Merge consecutive runs with identical style strings into a single ,
// matching pptxtojson's compact HTML output for better pptist compatibility.
let prevStyleStr: string | null = null;
let prevIsLink = false;
let accumulatedText = '';
const flushAccumulatedRun = () => {
if (!accumulatedText || prevStyleStr === null) return;
html += `${accumulatedText}`;
accumulatedText = '';
};
for (const run of paragraph.runs) {
// Inline formula run (公式与正文混排): render as inline KaTeX so the
// surrounding 中文 isn't lost and the formula isn't pulled out into its
// own stacked block. Falls back to the formula's plain text on failure.
if (run.ommlXml) {
flushAccumulatedRun();
prevStyleStr = null;
const mStyle: MergedRunStyle = {};
if (merged.defRPrs) {
for (const drp of merged.defRPrs) mergeRunProps(mStyle, drp, ctx);
}
if (run.properties) mergeRunProps(mStyle, run.properties, ctx);
const mSizePt = mStyle.fontSize ?? effectiveFontSize;
// OMML run color (a:rPr>solidFill) is dropped by the latex conversion, so
// when the inline formula is one color, resolve it from the captured node.
const mathColorNode = (run as { mathColorNode?: SafeXmlNode }).mathColorNode;
const mColor =
mathColorNode && mathColorNode.exists()
? resolveColorToCss(mathColorNode, ctx)
: (mStyle.color ?? options?.fontRefColor ?? '#000000');
const latex = ommlToLatex(run.ommlXml);
let mathHtml = '';
if (latex) {
try {
// throwOnError:true so invalid LaTeX throws → we fall back to the
// formula's plain text below, instead of KaTeX printing the raw
// source in red (the "红色 LaTeX 乱码" reviewers flagged).
mathHtml = katex.renderToString(latex, {
displayMode: false,
throwOnError: true,
});
} catch {
mathHtml = '';
}
}
const inlineBody = mathHtml || formatRunTextForHtml(run.text ?? '');
if (inlineBody) {
html += `${inlineBody}`;
}
prevIsLink = false;
continue;
}
if (run.text === '\n') {
flushAccumulatedRun();
prevStyleStr = null;
if (useLineWrappers) {
closeLineWrapper();
openLineWrapper();
} else {
html += '
';
}
continue;
}
// Build merged run style
const runStyle: MergedRunStyle = {};
// Apply default run properties from all inherited defRPr nodes
if (merged.defRPrs) {
for (const drp of merged.defRPrs) mergeRunProps(runStyle, drp, ctx);
}
// Level 7: run rPr
if (run.properties) {
mergeRunProps(runStyle, run.properties, ctx);
}
// Fallback: if no color resolved yet, check the shape's lstStyle defRPr.
if (runStyle.color === undefined && textBody.listStyle) {
const lstStyleLevel = findStyleAtLevel(textBody.listStyle, level);
if (lstStyleLevel.exists()) {
const lstDefRPr = lstStyleLevel.child('defRPr');
if (lstDefRPr.exists()) {
const fallbackStyle: MergedRunStyle = {};
mergeRunProps(fallbackStyle, lstDefRPr, ctx);
if (fallbackStyle.color !== undefined) {
runStyle.color = fallbackStyle.color;
}
}
}
}
let runText = run.text ?? '';
// 剥掉已折叠进段落 text-indent 的行首空白（见上「行首缩进折叠」）；
// 完全由空白构成的行首 run 折叠后为空，直接跳过不再输出。
if (leadingStripChars > 0 && runText) {
let k = 0;
while (
k < runText.length &&
leadingStripChars > 0 &&
(runText[k] === '\t' || runText[k] === ' ')
) {
k++;
leadingStripChars--;
}
if (k > 0) runText = runText.slice(k);
if (runText === '') continue;
}
//