PowerPoint（PPTX）技能

速查

| 任务 | 做法 | |------|------| | 读取/分析内容 | python -m markitdown presentation.pptx | | 按模板编辑或创建 | 阅读上游 editing.md | | 从零创建 | 阅读上游 pptxgenjs.md |

读取内容

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

# 视觉缩略图总览
python scripts/thumbnail.py presentation.pptx

# 解包查看原始 XML
python scripts/office/unpack.py presentation.pptx unpacked/

编辑工作流

完整步骤见上游 editing.md。

用 thumbnail.py 分析模板版式
解包 → 改幻灯片 → 改内容 → 清理 → 再打包

从零创建

完整步骤见上游 pptxgenjs.md。

无模板或参考稿时使用。

设计思路

不要做无聊幻灯片。 白底黑字项目符号很难给人留下印象。每张片子都可从下列方向取材。

动手前

大胆且贴合主题的配色：换到别的主题也「还能用」说明不够专精。
主次分明：一种主色占 60–70% 视觉权重，1–2 个辅色 + 一个强调色；不要平均分配。
深浅对比：标题/结尾页用深色，内容页浅色（「三明治」结构）；或全程深色走高端路线。
统一视觉母题：选一个元素贯穿全稿——圆角图框、彩色圆底图标、单侧粗边条等。

配色参考（十六进制）

| 主题 | 主色 | 辅色 | 强调 | |------|------|------|------| | Midnight Executive | 1E2761 | CADCFC | FFFFFF | | Forest & Moss | 2C5F2D | 97BC62 | F5F5F5 | | Coral Energy | F96167 | F9E795 | 2F3C7E | | Warm Terracotta | B85042 | E7E8D1 | A7BEAE | | Ocean Gradient | 065A82 | 1C7293 | 21295C | | Charcoal Minimal | 36454F | F2F2F2 | 212121 | | Teal Trust | 028090 | 00A896 | 02C39A | | Berry & Cream | 6D2E46 | A26769 | ECE2D0 | | Sage Calm | 84B59F | 69A297 | 50808E | | Cherry Bold | 990011 | FCF6F5 | 2F3C7E |

每一页

每页都要有视觉元素——图、表、图标或形状；纯文字页易被遗忘。

版式示例：

双栏（左文右图）
图标 + 标题 + 说明（图标放彩色圆里）
2×2 / 2×3 网格
半幅通栏图 + 叠字

数据展示： 大号数字（60–72pt）+ 小标签；对比栏；时间线/流程箭头。

点缀： 小标题旁彩色圆图标；关键数据用斜体强调。

字体

避免通篇 Arial。标题有个性，正文干净。

| 标题字体 | 正文字体 | |----------|----------| | Georgia | Calibri | | Arial Black | Arial | | Calibri | Calibri Light | | Cambria | Calibri | | Trebuchet MS | Calibri | | Impact | Arial | | Palatino | Garamond | | Consolas | Calibri |

| 元素 | 字号 | |------|------| | 标题 | 36–44pt 粗体 | | 小节标题 | 20–24pt 粗体 | | 正文 | 14–16pt | | 说明 | 10–12pt 略浅 |

留白

边距至少约 0.5 英寸
内容块间距 0.3–0.5 英寸
不要塞满每一寸

常见错误（避免）

每页版式雷同
正文居中（标题可居中，段落请左对齐）
标题与正文字号差太小（标题至少约 36pt）
默认蓝灰「通用科技风」
间距随意、一页精修其余敷衍
纯标题+项目符号无配图
对齐形状时忽略文本框内边距（可设 margin: 0 或微调形状位置）
图标/文字与背景对比不足
标题下加装饰线（典型「AI 生成感」）；用留白或色块区分即可

质检（必做）

默认认为有问题，你的任务是把它找出来。

第一版很少一次过关。把质检当「找 bug」，不是走过场。若第一遍「零问题」，多半查得不够细。

内容质检

python -m markitdown output.pptx

检查缺字、错字、顺序。

用模板时，检查占位符是否残留：

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

有输出则必须修完再算成功。

视觉质检

⚠️ 尽量用子代理——哪怕只有 2–3 页。自己盯代码容易「看见预期而非事实」。

先转图片（见下文），再用类似提示词让模型看图：

重叠（字压线、线穿字）
文字溢出或被裁切
装饰线按单行标题画但标题折成两行
脚注与正文打架
间距过密（<0.3"）或疏密不均
距页边 <0.5"
多栏不对齐
对比度不足（浅灰字配奶油底等）
文本框过窄导致过度折行
占位内容未删

验证闭环

生成 → 转图 → 检查
列出问题（若写「无」，再更苛刻查一遍）
修改
只重验改过的页——一改可能带出新问题
重复直到一整轮无新问题

至少完成一轮「修改 → 再验」前，不要宣称完成。

转为图片

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

得到 slide-01.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 转图

许可证以上游 LICENSE.txt 为准。

PowerPoint（pptx）处理

安装方式

CLI 安装（推荐）

手动下载安装

触发指令

使用指南