将扫描版 PDF、课件截图和图片型文档转换为尽量高保真、尽量可编辑的 PPTX。

中文 | English

在线文档 · 在线体验 · 快速开始 · 部署选项 · License

PDF2PPT 是一个面向实际使用和部署的开源服务。
它不是简单地把 PDF 每页导成一张图，而是尽量把页面重建为可编辑文本、独立图片区域和清理后的页面底图，再导出为 PowerPoint。

在线体验

项目	地址 / 信息
演示站点	https://ppt.015201314.xyz/
访问密码	123456

Warning

请 不要 上传 工作文档，避免隐私泄露。

界面预览

跟踪页面	任务记录

AIOCR 设置	云端 MinerU 设置

介绍

处理扫描版 PDF、课件截图和图片型文档时，常见做法往往只是整页截图导出，后续几乎无法编辑。
PDF2PPT 的目标不是“把 PDF 贴进 PPT”，而是尽量把页面重建为可编辑文本、独立图片区域和页面底图，在保留原稿观感的同时提高后续编辑能力。

典型问题	PDF2PPT 的处理方式
每页只能导成一张大图	尽量拆出文本层、图片块和页面底图
OCR 只是附加能力	OCR 与页面重建是核心链路
只能本地试一下	支持 Web、API、Worker 和标准部署
路线单一，难以调优	可切换本地 OCR、远程 OCR 与文档解析链路

为什么用它

• 不只是截图式导出，而是尽量把页面重建为文本层、图片块和页面底图
• 不只适合单机试用，也适合部署成 Web、API、Worker 的完整服务
• 不绑定单一路线，可以在本地 OCR、远程 OCR 和文档解析链路之间切换

适合谁

• 需要处理扫描版 PDF、课件截图、图片型报告的个人用户
• 想把 PDF 转 PPT 能力做成内部服务的团队或开发者
• 希望把转换流程接入自动化、脚本或 MCP 客户端的集成方

核心能力

• 高保真页面重建，优先兼顾原稿观感与可编辑性
• 支持本地 OCR、远程 OCR、百度文档解析、MinerU 等多种链路
• 提供 Web 上传、任务跟踪、结果下载和 API 接入
• 支持标准 Docker 部署、Hosted 单服务模式、Render 和 Zeabur

快速开始

本地体验

make dev-local

默认会启动：

• Web: http://localhost:3000
• API: http://127.0.0.1:8000

完整部署

适合完整部署 web + api + worker + redis：

cp .env.example .env
docker compose up -d --build

常用检查命令：

docker compose ps
docker compose logs -f
curl http://127.0.0.1:8000/health

轻量托管后端

适合先在云平台验证后端：

cp .env.example .env
docker compose -f docker-compose.hosted.yml up -d --build

推荐两种方式：

• 最低成本验证：REDIS_URL=memory://
• 接入托管 Redis：REDIS_URL=<your-redis-url> 且 EMBEDDED_WORKER_CONCURRENCY=1

基本使用流程

1. 上传 PDF
2. 提交转换参数并创建任务
3. 等待任务完成后下载 output.pptx

首次运行如果想优先求稳，建议从 remote_ocr + aiocr + fullpage 开始。

部署选项

模式	适合场景	入口
本地体验	本机快速试用与调试	make dev-local
完整部署	长期运行或生产部署	docker-compose.yml
轻量托管后端	云平台快速验证后端	docker-compose.hosted.yml
Render	一键部署	render.yaml
Zeabur	模板化部署	zeabur.template.yaml

MCP支持

• MCP 仓库

文档

更详细的架构、OCR 链路、MCP 集成、部署细节和 FAQ 已迁移到文档站：

• 文档站首页
• 功能详解
• 设置与高级设置
• 部署指南
• MCP 集成
• FAQ 与排障

License

MIT. See LICENSE.