pptx

概述

快速参考

读取内容

# 文本提取
python -m markitdown presentation.pptx

# 视觉概览
python scripts/thumbnail.py presentation.pptx

# 原始 XML
python scripts/office/unpack.py presentation.pptx unpacked/

编辑工作流

阅读 [editing.md](editing.md) 了解完整详情。

1. 使用 thumbnail.py 分析模板
2. 解包 → 操作幻灯片 → 编辑内容 → 清理 → 打包

从头创建

阅读 [pptxgenjs.md](pptxgenjs.md) 了解完整详情。

当没有模板或参考演示文稿可用时使用。

设计思路

不要创建无聊的幻灯片。 白底黑字的纯项目符号不会给任何人留下印象。考虑为每张幻灯片从此列表中选取思路。

开始前

• 选择大胆、内容相关的配色方案：配色方案应该感觉是针对此主题设计的。如果将其颜色换到完全不同的演示文稿中也能"适用"，说明你的选择还不够具体。
• 主次分明：一种颜色应占主导（60-70% 视觉权重），搭配 1-2 种辅助色调和一种锐利强调色。绝不给予所有颜色同等权重。
• 深色/浅色对比：标题和结论幻灯片使用深色背景，内容使用浅色（"三明治"结构）。或者全部使用深色以获得高级感。
• 坚持视觉主题：选择一个独特的元素并重复使用 — 圆角图片框、带颜色的圆圈图标、粗的单侧边框。在每张幻灯片上保持统一。

配色方案

选择与主题匹配的颜色 — 不要默认使用通用蓝色。使用这些方案作为灵感：

每张幻灯片

每张幻灯片都需要一个视觉元素 — 图片、图表、图标或形状。纯文字幻灯片容易被遗忘。

布局选项：

• 双列（左文右图）
• 图标 + 文字行（彩色圆圈中的图标、粗体标题、下方描述）
• 2×2 或 2×3 网格（一侧图片，另一侧内容块网格）
• 半边出血图片（完整左侧或右侧）覆盖内容

数据展示：

• 大数字标注（60-72pt 大数字，下方小标签）
• 比较列（前后、优缺点、并排选项）
• 时间线或流程（编号步骤、箭头）

视觉修饰：

• 区域标题旁的小彩色圆圈中的图标
• 关键数据或标语使用斜体强调文本

排版

选择有趣的字体组合 — 不要默认使用 Arial。选择有个性的标题字体并搭配清晰的正文字体。

间距

• 最小边距 0.5"
• 内容块之间 0.3-0.5"
• 留出呼吸空间 — 不要填满每一寸

避免（常见错误）

• 不要重复相同布局 — 在幻灯片之间变化列、卡片和标注方式
• 不要居中对齐正文 — 段落和列表左对齐；仅标题居中
• 不要吝啬大小对比 — 标题需要 36pt+ 才能从 14-16pt 正文中脱颖而出
• 不要默认使用蓝色 — 选择反映特定主题的颜色
• 不要随意混合间距 — 选择 0.3" 或 0.5" 的间距并一致使用
• 不要只设计一张幻灯片而其他保持平淡 — 要么全部投入，要么全篇保持简洁
• 不要创建纯文本幻灯片 — 添加图片、图标、图表或视觉元素；避免纯标题 + 项目符号
• 不要忘记文本框内边距 — 对齐线条或形状与文本边缘时，在文本框上设置 margin: 0 或偏移形状以考虑内边距
• 不要使用低对比度元素 — 图标和文本都需要与背景有强烈的对比；避免浅色文字在浅色背景上或深色文字在深色背景上
• 绝不在标题下使用强调线 — 这是 AI 生成幻灯片的标志；使用空白或背景色代替

质量保证（必需）

假设存在问题。你的工作是找出它们。

你的第一次渲染几乎永远不正确。将 QA 视为找 bug 的过程，而非确认步骤。如果第一次检查发现零问题，说明你看得不够仔细。

内容 QA

python -m markitdown output.pptx

检查缺失内容、错别字、顺序错误。

使用模板时，检查遗留的占位符文本：

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

如果 grep 返回结果，在宣布成功前修复它们。

视觉 QA

⚠️ 使用子代理 — 即使是 2-3 张幻灯片。你一直盯着代码，只会看到你期望的内容，而不是实际存在的内容。子代理有全新的视角。

将幻灯片转换为图像（见[转换为图像](#转换为图像)），然后使用此提示：

视觉检查这些幻灯片。假设存在问�� — 找出它们。

查找：
- 重叠元素（文本透过形状、线条穿过文字、堆叠元素）
- 文本溢出或在边缘/框边界处被截断
- 为单行文本定位的装饰线，但标题换行为两行
- 来源引用或页脚与上方内容碰撞
- 元素太近（< 0.3" 间距）或卡片/区域几乎接触
- 间距不均匀（一处大块空白，另一处拥挤）
- 距幻灯片边缘边距不足（< 0.5"）
- 列或类似元素未对齐一致
- 低对比度文本（例如浅灰色文字在奶油色背景上）
- 低对比度图标（例如深色图标在深色背景上，无对比色圆圈）
- 文本框太窄导致过多换行
- 遗留的占位符内容

对每张幻灯片，列出问题或关注区域，即使是很小的问题。

阅读并分析这些图片：
1. /path/to/slide-01.jpg（预期：[简要描述]）
2. /path/to/slide-02.jpg（预期：[简要描述]）

报告所有发现的问题，包括小问题。

验证循环

1. 生成幻灯片 → 转换为图像 → 检查
2. 列出发现的问题（如未发现问题，以更批判的眼光重看）
3. 修复问题
4. 重新验证受影响的幻灯片 — 一个修复常常产生另一个问题
5. 重复直到完整通过未发现新问题

在完成至少一轮修复和验证循环之前，不要宣布成功。

转换为图像

将演示文稿转换为单个幻灯片图像用于视觉检查：

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

这将创建 slide-01.jpg、slide-02.jpg 等。

修复后重新渲染特定幻灯片：

pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed

依赖项

• pip install "markitdown[pptx]" – 文本提取
• pip install Pillow – 缩略图网格
• npm install -g pptxgenjs – 从头创建
• LibreOffice（soffice）- PDF 转换（通过 scripts/office/soffice.py 为沙箱环境自动配置）
• Poppler（pdftoppm）- PDF 转图片