Python将PPT转Markdown：整份/单页/范围代

脚本专家

PowerPoint 常用于企业报告、技术培训和项目评审，但当内容需要复用到技术文档、网站、知识库或 Git 仓库时，Markdown 更轻量、易编辑，也更容易纳入自动化文档流程。手工复制每页幻灯片再排版成本高，可以用 Python 将 PPT/PPTX 转成 Markdown。本文使用 Spire.Presentation for Python，该库提供创建、读取、编辑和转换 PowerPoint 的 API，且不需要系统安装 Microsoft PowerPoint。

安装组件：

pip install Spire.Presentation

一、整个 PowerPoint 演示文稿转 Markdown

流程是创建 Presentation 对象，用 LoadFromFile() 加载 .ppt 或 .pptx，再用 SaveToFile() 以 FileFormat.Markdown 输出，最后 Dispose() 释放资源。

2. from spire.presentation import Presentation, FileFormat
3. # 输入 PowerPoint 文件（.ppt 和 .pptx 格式均支持）
4. inputFile = 'Sample.pptx'
5. # 输出 Markdown 文件
6. outputFile = 'PresentationToMarkdown.md'
7. # 创建 Presentation 对象
8. presentation = Presentation()
9. # 加载 PowerPoint 演示文稿
10. presentation.LoadFromFile(inputFile)
11. # 将 PowerPoint 转换为 Markdown
12. presentation.SaveToFile(outputFile, FileFormat.Markdown)
13. # 释放资源
14. presentation.Dispose()

复制代码

运行后，整个演示文稿内容会导出到 Markdown 文件。

二、指定单个幻灯片转 Markdown

如果只需要某一页作为独立文档，可以直接访问目标幻灯片，再对该幻灯片调用 SaveToFile()。注意幻灯片集合索引从 0 开始，Slides[1] 表示第二张幻灯片。

2. from spire.presentation import Presentation, FileFormat
3. # 输入 PowerPoint 文件
4. inputFile = 'Sample.pptx'
5. # 输出 Markdown 文件
6. outputFile = 'SlideToMarkdown.md'
7. # 创建 Presentation 对象
8. presentation = Presentation()
9. # 加载 PowerPoint 演示文稿
10. presentation.LoadFromFile(inputFile)
11. # 获取第二张幻灯片
12. slide = presentation.Slides[1]
13. # 将幻灯片转换为 Markdown
14. slide.SaveToFile(outputFile, FileFormat.Markdown)
15. # 释放资源
16. presentation.Dispose()

复制代码

三、指定范围幻灯片转独立 Markdown

更常见的需求是导出某个章节，例如第 2 到第 5 页。做法是加载源文件，创建新 Presentation，删除其默认幻灯片，再把指定范围内的幻灯片逐个 Append 到新演示文稿，最后保存为 Markdown。这样不会修改原始 PPT。用户页码从 1 开始，访问底层集合时需要对 startSlide 减 1。

2. from spire.presentation import Presentation, FileFormat
3. # 输入 PowerPoint 文件
4. inputFile = 'Sample.pptx'
5. # 输出 Markdown 文件
6. outputFile = 'SelectedSlides.md'
7. # 要转换的幻灯片范围（从 1 开始计数）
8. startSlide = 2
9. endSlide = 5
10. # 加载源演示文稿
11. sourcePresentation = Presentation()
12. sourcePresentation.LoadFromFile(inputFile)
13. # 获取幻灯片总数量
14. totalSlides = sourcePresentation.Slides.Count
15. # 验证幻灯片范围
16. if startSlide < 1 or endSlide > totalSlides or startSlide > endSlide:
17.     raise ValueError('无效幻灯片范围。')
18. # 创建新的演示文稿
19. newPresentation = Presentation()
20. # 删除默认幻灯片
21. newPresentation.Slides.RemoveAt(0)
22. # 复制指定范围的幻灯片
23. for i in range(startSlide - 1, endSlide):
24.     newPresentation.Slides.Append(sourcePresentation.Slides[i])
25. # 将指定幻灯片转换为 Markdown
26. newPresentation.SaveToFile(outputFile, FileFormat.Markdown)
27. # 释放资源
28. sourcePresentation.Dispose()
29. newPresentation.Dispose()

复制代码

转换前需要注意的问题

PowerPoint 和 Markdown 的组织方式不同。标题、段落、项目符号列表通常能保留，因为 Markdown 原生支持这些结构化文本；但自定义字体、颜色、精确位置控制等复杂格式可能无法完全保持。图片、形状、流程图等视觉元素要检查是否正确嵌入、位置是否符合展示需求。复杂布局、对象重叠或高度定制设计的幻灯片，转换后可能需要手动调整。简单表格通常较容易转换，合并单元格或复杂格式表格仍需调整；图表和数据可视化内容可能需要按目标平台转成图片或重新设计。PowerPoint 动画、切换效果和交互功能不能转换为 Markdown。

常见问题

可以在不安装 Microsoft PowerPoint 的情况下转换吗？可以，通过基于 Python 的 PowerPoint 处理 API 即可完成。可以只转换一张幻灯片吗？可以，直接对指定幻灯片保存为 Markdown。可以转换多个指定幻灯片而不是整个演示文稿吗？可以，把需要的幻灯片复制到新演示文稿后再保存为 Markdown。Markdown 会保留 PowerPoint 原始布局吗？不会，它能保留文本、列表等结构化内容，但无法保持固定幻灯片布局，复杂设计、对象重叠或精确定位通常要后续调整。动画和切换效果能转换吗？不能。

总结

使用 Python 将 PowerPoint 转 Markdown，适合把幻灯片内容迁移到技术文档、在线发布页面、知识库或 Git 仓库，也适合构建批量文档处理流程。核心调用是 Presentation.LoadFromFile() 读取源文件、SaveToFile(..., FileFormat.Markdown) 输出，以及按 Slides 索引选择单页或复制指定范围。注意幻灯片集合索引从 0 开始，用户页码范围从 1 开始，代码中要做好减 1 和范围校验。