title: “Powerpoint — Create, read, edit” sidebar_label: “Powerpoint” description: “Create, read, edit”
{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能对应的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}
PowerPoint
创建、读取、编辑 .pptx 格式的演示文稿、幻灯片、备注及模板。
技能元数据
| 来源 | 内置（默认已安装） |
| 路径 | skills/productivity/powerpoint |
| 许可证 | 专有许可证。详细条款见 LICENSE.txt 文件 |
| 支持平台 | linux、macos、windows |
参考：完整 SKILL.md 文件
PowerPoint 技能
适用场景
每当涉及 .pptx 文件时，无论作为输入、输出还是两者兼有，均可使用此技能。应用场景包括：创建演示文稿、商业计划书或各类报告；从任何 .pptx 文件中读取、解析或提取文本（即便提取出的内容后续会被用于邮件或总结中）；编辑、修改或更新现有演示文稿；合并或拆分幻灯片文件；处理模板、布局、演讲者备注或评论。只要用户提到“演示文稿”“幻灯片”“报告”，或提及 .pptx 文件名，即可触发该技能，无需考虑其后续要对内容进行何种操作。若需要打开、创建或修改 .pptx 文件，均可使用此技能。
快速参考
| 任务 | 指引 |
|---|---|
| 读取/分析内容 | python -m markitdown presentation.pptx |
| 基于模板进行编辑或创建 | 阅读 editing.md |
| 从零开始创建 | 阅读 pptxgenjs.md |
读取内容
# Text extraction
python -m markitdown presentation.pptx
# Visual overview
python scripts/thumbnail.py presentation.pptx
# Raw XML
python scripts/office/unpack.py presentation.pptx unpacked/
编辑工作流程
详细内容请参阅 editing.md。
- 使用
thumbnail.py分析模板 - 解压 → 操作幻灯片 → 编辑内容 → 清理 → 打包
从零开始创建
详细内容请参阅 pptxgenjs.md。
在无法使用模板或参考演示文稿时使用此方法。
设计思路
避免制作枯燥的幻灯片。 纯白的背景配上简单的项目符号根本无法打动观众。为每张幻灯片参考以下建议。
开始之前
- 选择大胆且贴合主题的配色方案：配色应专为当前主题设计。如果将这些颜色应用到完全不同的演示文稿中依然适用，说明你的选择还不够具体。
- 主次分明：应有一种颜色占据主导地位（视觉占比60-70%），再搭配1-2种辅助色调以及1种醒目的强调色。切勿让所有颜色的视觉权重相等。
- 明暗对比：标题页和总结页可使用深色背景，内容页则用浅色背景（即“三明治”结构）。或者全程采用深色风格以营造高级感。
- 确定统一视觉元素：挑选一个独特的元素并贯穿所有幻灯片——如圆角图片框、彩色圆圈中的图标、粗单边边框等。
配色方案
选择与主题相匹配的颜色，不要默认使用通用的蓝色。以下配色方案可供参考：
| 主题 | 主色调 | 辅助色 | 强调色 |
|---|---|---|---|
| 午夜商务风 | 1E2761（深蓝） | CADCFC（冰蓝） | FFFFFF（白色） |
| 森林苔藓风 | 2C5F2D（森林绿） | 97BC62（苔藓绿） | F5F5F5（奶油色） |
| 珊瑚活力风 | F96167（珊瑚红） | F9E795（金色） | 2F3C7E（深蓝） |
| 温暖赤陶风 | B85042（赤陶色） | E7E8D1（沙色） | A7BEAE（鼠尾草绿） |
| 海洋渐变风 | 065A82（深蓝） | 1C7293（青绿色） | 21295C（午夜蓝） |
| 炭灰极简风 | 36454F（炭灰色） | F2F2F2（米白色） | 212121（黑色） |
| 青绿信任风 | 028090（青绿色） | 00A896（海藻绿） | 02C39A（薄荷绿） |
| 浆果奶油风 | 6D2E46（浆果红） | A26769（玫瑰粉） | ECE2D0（奶油色） |
| 鼠尾草宁静风 | 84B59F（鼠尾草绿） | 69A297（桉树绿） | 50808E（板岩灰） |
| 樱桃醒目风 | 990011（樱桃红） | FCF6F5（米白色） | 2F3C7E（深蓝） |
每张幻灯片的设计要点
每张幻灯片都需要视觉元素——如图片、图表、图标或形状。仅有文字的幻灯片极易被遗忘。
布局选项：
- 双栏布局（左侧为文字，右侧为插图）
- 图标+文字行布局（图标置于彩色圆圈中，上方为醒目标题，下方为描述文字）
- 2x2或2x3网格布局（一侧放置图片，另一侧排列内容块）
- 半透出图片布局（图片占据左侧或右侧整个区域），并在其上叠加文字内容
数据展示方式：
- 大型数据标注（数字大小为60-72磅，下方附有小标签）
- 对比列展示（前后对比、优缺点对比、并列选项对比）
- 时间轴或流程图（带编号的步骤及箭头指示）
视觉优化技巧：
- 在章节标题旁添加小型彩色圆圈中的图标
- 用斜体突出显示关键数据或标语
字体选择
挑选有趣的字体组合——不要默认使用Arial。选择一个有特色的标题字体，并搭配简洁的正文字体。
| 标题字体 | 正文字体 |
|---|---|
| Georgia | Calibri |
| Arial Black | Arial |
| Calibri | Calibri Light |
| Cambria | Calibri |
| Trebuchet MS | Calibri |
| Impact | Arial |
| Palatino | Garamond |
| Consolas | Calibri |
| 元素 | 字号大小 |
|---|---|
| 幻灯片标题 | 36-44磅，加粗 |
| 章节标题 | 20-24磅，加粗 |
| 正文文字 | 14-16磅 |
| 图注文字 | 10-12磅，浅色 |
缺距设置
- 最小边距为0.5英寸
- 各内容块之间的间距为0.3-0.5英寸
- 保留适当空隙，避免填满所有空间
需避免的常见错误
- 避免重复同一布局：在不同幻灯片中变换列式、卡片样式和标注方式
- 避免将正文文字居中：段落和列表应左对齐，仅标题可居中
- 注意大小对比度：标题字号需达到36磅以上，才能在14-16磅的正文文字中突出显示
- 避免默认使用蓝色：应选择能体现主题特色的颜色
- 避免随意设置间距：选定0.3英寸或0.5英寸的固定间距并保持一致
- 避免只设计一张精美幻灯片，其余保持简单：要么全面优化，要么整体保持简洁风格
- 避免制作仅有文字的幻灯片：务必添加图片、图标、图表等视觉元素，避免仅使用标题和项目符号
- 注意文本框的内边距：在将线条或形状与文本边缘对齐时，需为文本框设置
margin: 0，或调整形状位置以考虑内边距影响 - 避免使用对比度低的元素：图标和文字都需要与背景形成强烈对比；避免在浅色背景上使用浅色文字，或在深色背景上使用深色文字
- 绝对不要在标题下方添加强调线：这是AI生成幻灯片的典型特征，应改用空白区域或背景色替代
质量检查（必做）
假设必然存在问题，你的任务就是找出它们。
初次生成的结果几乎从不完美。应将质量检查视为查找缺陷的过程，而非简单的确认步骤。如果初次检查就未发现任何问题，说明你检查得还不够仔细。
内容质量检查
python -m markitdown output.pptx
检查是否存在内容缺失、拼写错误或顺序不当的问题。
在使用模板时，还需确认是否还有残留的占位符文本：
python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"
如果 grep 返回了结果，在宣布任务成功之前必须先修复这些问题。
视觉质量检测
⚠️ 请务必使用子智能体——即便只有 2-3 张幻灯片也不例外。您长时间盯着代码查看，很容易看到自己期望看到的内容而非实际存在的状况。子智能体则能带来全新的视角。
首先将幻灯片转换为图像（详见转换为图像），然后再使用以下提示词：
Visually inspect these slides. Assume there are issues — find them.
Look for:
- Overlapping elements (text through shapes, lines through words, stacked elements)
- Text overflow or cut off at edges/box boundaries
- Decorative lines positioned for single-line text but title wrapped to two lines
- Source citations or footers colliding with content above
- Elements too close (< 0.3" gaps) or cards/sections nearly touching
- Uneven gaps (large empty area in one place, cramped in another)
- Insufficient margin from slide edges (< 0.5")
- Columns or similar elements not aligned consistently
- Low-contrast text (e.g., light gray text on cream-colored background)
- Low-contrast icons (e.g., dark icons on dark backgrounds without a contrasting circle)
- Text boxes too narrow causing excessive wrapping
- Leftover placeholder content
For each slide, list issues or areas of concern, even if minor.
Read and analyze these images:
1. /path/to/slide-01.jpg (Expected: [brief description])
2. /path/to/slide-02.jpg (Expected: [brief description])
Report ALL issues found, including minor ones.
验证循环
- 生成幻灯片 → 转换为图片 → 检查
- 列出发现的问题（若未发现问题，则需更仔细地重新检查）
- 修复问题
- 重新验证受影响的幻灯片——通常一次修复会引发新的问题
- 重复上述步骤，直到全部检查均未发现新问题为止
在完成至少一个“修复-验证”循环之前，切勿宣布任务成功。
转换为图片
将演示文稿转换为单个幻灯片图片，以便进行可视化检查：
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转换为图像文件