快速开始

# 基本转换
pdf-to-pptx-tool convert document.pdf slides.pptx

# 高质量 (300 DPI)
pdf-to-pptx-tool convert report.pdf presentation.pptx --dpi 300

# 使用详细日志记录
pdf-to-pptx-tool -v convert input.pdf output.pptx

渐进式说明

convert - 将 PDF 转换为 PowerPoint

将 PDF 文档转换为 PowerPoint 格式，每个 PDF 页面创建一张幻灯片，并具有可自定义的质量设置。

用法：

pdf-to-pptx-tool convert INPUT_PDF OUTPUT_PPTX [OPTIONS]

参数：

• INPUT_PDF: 输入 PDF 文件的路径（必需）
  • 必须存在且为有效的 PDF 文件
  • 支持任何 PDF 版本
  • 无大小限制（取决于内存）
• OUTPUT_PPTX: 输出 PowerPoint 文件的路径（必需）
  • 将被创建或覆盖
  • 扩展名应为 .pptx
  • 父目录必须存在
• --dpi INTEGER: 页面转换的分辨率（可选）
  • 默认值: 200 DPI（质量良好，大小合理）
  • 范围: 72-600 DPI
  • DPI 越高 = 质量越好但文件越大
  • 推荐值: 200-300 用于演示文稿
• -v, --verbose: 多级详细程度
  • 无标志: 仅警告/错误
  • -v: INFO 级别（操作和进度）
  • -vv: DEBUG 级别（详细步骤）
  • -vvv: TRACE 级别（库内部信息）

示例：

# 示例 1: 基本转换 (默认 200 DPI)
pdf-to-pptx-tool convert quarterly-report.pdf q4-presentation.pptx

# 示例 2: 高质量用于详细图表
pdf-to-pptx-tool convert technical-diagram.pdf slides.pptx --dpi 300

# 示例 3: 较低质量用于快速预览
pdf-to-pptx-tool convert draft.pdf preview.pptx --dpi 150

# 示例 4: 使用 INFO 日志记录查看进度
pdf-to-pptx-tool -v convert large-doc.pdf output.pptx

# 示例 5: 使用 DEBUG 日志记录进行故障排除
pdf-to-pptx-tool -vv convert problematic.pdf fixed.pptx

# 示例 6: 使用 Shell 循环进行批量转换
for pdf in *.pdf; do
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx"
done

输出：

• 在指定路径创建 PowerPoint 文件
• 幻灯片属性：
  • 宽高比: 16:9 (宽屏)
  • 尺寸: 10" × 5.625"
  • 布局: 每个 PDF 页面一张全幻灯片图像
  • 背景: 透明
• 控制台输出：
  • 成功: "✓ 成功将 input.pdf 转换为 output.pptx"
  • 错误: "✗ 错误: [详细错误信息]"
• 退出代码：
  • 0: 成功
  • 1: 错误（文件未找到、输入无效、转换失败）

completion - 生成 Shell 自动补全脚本

为 bash、zsh 或 fish shell 生成自动补全脚本。

用法：

pdf-to-pptx-tool completion SHELL

参数：

• SHELL: Shell 类型（必需）
  • 选项: bash, zsh, fish
  • 不区分大小写

示例：

# 生成 bash 自动补全
eval "$(pdf-to-pptx-tool completion bash)"

# 生成 zsh 自动补全
eval "$(pdf-to-pptx-tool completion zsh)"

# 生成 fish 自动补全
pdf-to-pptx-tool completion fish | source

# 保存到文件以永久安装
pdf-to-pptx-tool completion bash > ~/.pdf-to-pptx-tool-completion.bash
echo 'source ~/.pdf-to-pptx-tool-completion.bash' >> ~/.bashrc

输出： 打印到标准输出的 Shell 特定自动补全脚本。

多级详细日志记录

该工具支持渐进式详细级别，用于调试和监控转换过程。

日志记录级别：

示例：

# 静默模式 - 仅查看错误
pdf-to-pptx-tool convert input.pdf output.pptx

# INFO - 查看转换进度
pdf-to-pptx-tool -v convert input.pdf output.pptx
# 输出:
# [INFO] 开始 PDF 到 PPTX 转换
# [INFO] 将 input.pdf 转换为 output.pptx (DPI: 200)
# [INFO] 将 PDF 页面转换为图像...
# [INFO] 已转换 5 页
# [INFO] 创建 PowerPoint 演示文稿...
# [INFO] 将演示文稿保存到 output.pptx

# DEBUG - 查看详细处理过程
pdf-to-pptx-tool -vv convert input.pdf output.pptx
# 额外输出:
# [DEBUG] 输入: input.pdf, 输出: output.pptx, DPI: 200
# [DEBUG] 验证输入文件: input.pdf
# [DEBUG] 输入文件大小: 2.45 MB
# [DEBUG] 使用 DPI 设置: 200
# [DEBUG] 处理幻灯片 1/5
# [DEBUG] 输出文件大小: 8.23 MB

# TRACE - 查看库内部信息
pdf-to-pptx-tool -vvv convert input.pdf output.pptx
# 显示 pdf2image、PIL 和 pptx 库的调试信息

DPI 质量指南

根据您的使用场景选择 DPI：

权衡：

• 更高的 DPI : 质量更好，文件更大，转换更慢
• 更低的 DPI : 转换更快，文件更小，质量更低
• 最佳平衡点 : 对于大多数演示文稿，200-300 DPI

批量处理

高效处理多个 PDF：

# 转换目录中的所有 PDF
for pdf in *.pdf; do
  echo "正在转换 $pdf..."
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx"
done

# 使用自定义 DPI
for pdf in *.pdf; do
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx" --dpi 300
done

# 带错误处理
for pdf in *.pdf; do
  if pdf-to-pptx-tool -v convert "$pdf" "${pdf%.pdf}.pptx"; then
    echo "✓ 已转换 $pdf"
  else
    echo "✗ 转换 $pdf 失败"
  fi
done

Shell 自动补全

启用 Tab 自动补全以加快使用速度：

# Bash - 添加到 ~/.bashrc
eval "$(pdf-to-pptx-tool completion bash)"

# Zsh - 添加到 ~/.zshrc
eval "$(pdf-to-pptx-tool completion zsh)"

# Fish - 保存到自动补全目录
mkdir -p ~/.config/fish/completions
pdf-to-pptx-tool completion fish > ~/.config/fish/completions/pdf-to-pptx-tool.fish

好处：

• Tab 自动补全命令: pdf-to-pptx-tool <TAB>
• Tab 自动补全选项: pdf-to-pptx-tool convert --<TAB>
• 自动 Tab 自动补全文件路径

常见问题

问题: "poppler not found" 或 PDF 转换失败

# 症状
RuntimeError: Failed to convert PDF pages: poppler not found

解决方案: 安装 poppler 系统库：

# macOS
brew install poppler

# Ubuntu/Debian
sudo apt-get install poppler-utils

# Fedora
sudo dnf install poppler-utils

# 验证安装
pdftoppm -v

问题: "File not found" 错误

# 症状
✗ Error: Input PDF file not found: document.pdf

解决方案：

• 验证文件路径是否正确

• 如果需要，使用绝对路径

• 检查文件权限

  检查文件是否存在

  ls -l document.pdf

  使用绝对路径

  pdf-to-pptx-tool convert /full/path/to/document.pdf output.pptx

问题: 输出文件太大

# 症状
Generated 50MB PPTX from 2MB PDF

解决方案: 降低 DPI 设置：

# 尝试更低的 DPI
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 150

# 或使用默认的 200 DPI
pdf-to-pptx-tool convert input.pdf output.pptx

问题: PowerPoint 中的图像看起来模糊

# 症状
Text and diagrams appear pixelated

解决方案: 提高 DPI 设置：

# 使用更高质量
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 300

# 用于打印质量
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 600

问题: 转换非常慢

# 症状
Large PDF takes minutes to convert

解决方案：

1. 使用 DEBUG 日志记录查看进度：

pdf-to-pptx-tool -vv convert large.pdf output.pptx

1. 考虑使用更低的 DPI 以加快转换速度：

pdf-to-pptx-tool convert large.pdf output.pptx --dpi 150

1. 将大型 PDF 分割成块并分别转换

问题: 写入输出文件时权限被拒绝

# 症状
PermissionError: [Errno 13] Permission denied: 'output.pptx'

解决方案：

• 检查目录写入权限

• 使用不同的输出位置

  写入到主目录

  pdf-to-pptx-tool convert input.pdf ~/output.pptx

  或先创建目录

  mkdir -p output-dir pdf-to-pptx-tool convert input.pdf output-dir/output.pptx

获取帮助

# 工具帮助
pdf-to-pptx-tool --help

# 命令帮助
pdf-to-pptx-tool convert --help

# 自动补全帮助
pdf-to-pptx-tool completion --help

# 版本信息
pdf-to-pptx-tool --version

调试工作流程

当转换失败时，使用此调试工作流程：

# 1. 检查文件是否存在且可读
ls -lh document.pdf
file document.pdf

# 2. 验证 poppler 是否已安装
pdftoppm -v

# 3. 尝试使用 DEBUG 日志记录
pdf-to-pptx-tool -vv convert document.pdf test.pptx

# 4. 如果内存问题，尝试使用更低的 DPI
pdf-to-pptx-tool -vv convert document.pdf test.pptx --dpi 150

# 5. 检查 Python 和依赖项
python --version
pdf-to-pptx-tool --version

退出代码

• 0: 成功 - 转换成功完成
• 1: 错误 - 文件未找到、输入无效、转换失败或权限被拒绝

输出格式

默认 PowerPoint 输出：

• 格式 : Office Open XML (.pptx)
• 宽高比 : 16:9 宽屏
• 幻灯片尺寸 : 10 英寸 × 5.625 英寸
• 布局 : 每个 PDF 页面一张全幻灯片图像
• 图像格式 : PNG 嵌入幻灯片中
• 兼容性 : PowerPoint 2007+ (Windows/Mac/在线版)

控制台输出：

# 成功
✓ 成功将 document.pdf 转换为 slides.pptx

# 错误
✗ 错误: 输入 PDF 文件未找到: document.pdf

日志记录输出 (使用 -v/-vv/-vvv)：

[INFO] 开始 PDF 到 PPTX 转换
[INFO] 将 document.pdf 转换为 slides.pptx (DPI: 200)
[DEBUG] 输入文件大小: 2.45 MB
[INFO] 已转换 10 页
[DEBUG] 输出文件大小: 12.78 MB
[INFO] 转换成功完成

最佳实践

1. 从默认 DPI (200) 开始 : 质量和文件大小的良好平衡
2. 使用详细日志记录进行调试 : -vv 显示详细的转换步骤
3. 首先使用示例 PDF 进行测试 : 在批量处理前验证质量
4. 监控输出文件大小 : 如果文件太大，调整 DPI
5. 高效批量处理 : 对多个文件使用 Shell 循环
6. 启用 Shell 自动补全 : 加快命令行使用速度
7. 保持 poppler 更新 : 确保与最新 PDF 功能的兼容性
8. 使用绝对路径 : 避免相对路径的混淆
9. 验证先决条件 : 在批量转换前检查 poppler 安装
10. 优雅地处理错误 : 在脚本中检查退出代码

资源

• GitHub 仓库 : https://github.com/dnvriend/pdf-to-pptx-tool
• Python 依赖项 :
  • pdf2image (PDF 到图像转换)
  • python-pptx (PowerPoint 文件创建)
  • Pillow (图像处理)
  • Click (CLI 框架)
• 系统依赖项 : poppler (PDF 渲染引擎)
• 相关工具 :
  • PyPDF2 (PDF 文本提取)
  • ReportLab (PDF 生成)
  • pandoc (通用文档转换器)

每周安装数

136

仓库

dnvriend/pdf-to…ptx-tool

首次出现

2026年1月22日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

安装于

opencode126

gemini-cli122

codex121

github-copilot118

cursor114

kimi-cli113

# Clone the repository
git clone https://github.com/dnvriend/pdf-to-pptx-tool.git
cd pdf-to-pptx-tool

# Install globally with uv
uv tool install .

Prerequisites

• Python 3.14+
• poppler system library (for PDF rendering)
  • macOS: brew install poppler
  • Ubuntu/Debian: apt-get install poppler-utils
  • Windows: Download from poppler releases

Quick Start

# Basic conversion
pdf-to-pptx-tool convert document.pdf slides.pptx

# High quality (300 DPI)
pdf-to-pptx-tool convert report.pdf presentation.pptx --dpi 300

# With verbose logging
pdf-to-pptx-tool -v convert input.pdf output.pptx

Progressive Disclosure

convert - Convert PDF to PowerPoint

Converts a PDF document to PowerPoint format, creating one slide per PDF page with customizable quality settings.

Usage:

pdf-to-pptx-tool convert INPUT_PDF OUTPUT_PPTX [OPTIONS]

Arguments:

• INPUT_PDF: Path to input PDF file (required)
  • Must exist and be a valid PDF file
  • Supports any PDF version
  • No size limit (memory permitting)
• OUTPUT_PPTX: Path to output PowerPoint file (required)
  • Will be created or overwritten
  • Extension should be .pptx
  • Parent directory must exist
• --dpi INTEGER: Resolution for page conversion (optional)
  • Default: 200 DPI (good quality, reasonable size)
  • Range: 72-600 DPI
  • Higher DPI = better quality but larger files
  • Recommended: 200-300 for presentations
• -v, --verbose: Multi-level verbosity
  • No flag: Warnings/errors only
  • -v: INFO level (operations and progress)
  • -vv: DEBUG level (detailed steps)
  • -vvv: TRACE level (library internals)

Examples:

# Example 1: Basic conversion (default 200 DPI)
pdf-to-pptx-tool convert quarterly-report.pdf q4-presentation.pptx

# Example 2: High quality for detailed diagrams
pdf-to-pptx-tool convert technical-diagram.pdf slides.pptx --dpi 300

# Example 3: Lower quality for quick preview
pdf-to-pptx-tool convert draft.pdf preview.pptx --dpi 150

# Example 4: With INFO logging to see progress
pdf-to-pptx-tool -v convert large-doc.pdf output.pptx

# Example 5: With DEBUG logging for troubleshooting
pdf-to-pptx-tool -vv convert problematic.pdf fixed.pptx

# Example 6: Batch conversion with shell loop
for pdf in *.pdf; do
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx"
done

Output:

• Creates PowerPoint file at specified path
• Slide properties:
  • Aspect ratio: 16:9 (widescreen)
  • Dimensions: 10" × 5.625"
  • Layout: One full-slide image per PDF page
  • Background: Transparent
• Console output:
  • Success: "✓ Successfully converted input.pdf to output.pptx"
  • Error: "✗ Error: [detailed error message]"
• Exit codes:
  • 0: Success
  • 1: Error (file not found, invalid input, conversion failed)

completion - Generate shell completion scripts

Generates shell completion scripts for bash, zsh, or fish shells.

Usage:

pdf-to-pptx-tool completion SHELL

Arguments:

• SHELL: Shell type (required)
  • Options: bash, zsh, fish
  • Case-insensitive

Examples:

# Generate bash completion
eval "$(pdf-to-pptx-tool completion bash)"

# Generate zsh completion
eval "$(pdf-to-pptx-tool completion zsh)"

# Generate fish completion
pdf-to-pptx-tool completion fish | source

# Save to file for permanent installation
pdf-to-pptx-tool completion bash > ~/.pdf-to-pptx-tool-completion.bash
echo 'source ~/.pdf-to-pptx-tool-completion.bash' >> ~/.bashrc

Output: Shell-specific completion script printed to stdout.

Multi-Level Verbosity Logging

The tool supports progressive verbosity levels for debugging and monitoring conversions.

Logging Levels:

Examples:

# Quiet mode - only see errors
pdf-to-pptx-tool convert input.pdf output.pptx

# INFO - see conversion progress
pdf-to-pptx-tool -v convert input.pdf output.pptx
# Output:
# [INFO] Starting PDF to PPTX conversion
# [INFO] Converting input.pdf to output.pptx (DPI: 200)
# [INFO] Converting PDF pages to images...
# [INFO] Converted 5 pages
# [INFO] Creating PowerPoint presentation...
# [INFO] Saving presentation to output.pptx

# DEBUG - see detailed processing
pdf-to-pptx-tool -vv convert input.pdf output.pptx
# Additional output:
# [DEBUG] Input: input.pdf, Output: output.pptx, DPI: 200
# [DEBUG] Validating input file: input.pdf
# [DEBUG] Input file size: 2.45 MB
# [DEBUG] Using DPI setting: 200
# [DEBUG] Processing slide 1/5
# [DEBUG] Output file size: 8.23 MB

# TRACE - see library internals
pdf-to-pptx-tool -vvv convert input.pdf output.pptx
# Shows pdf2image, PIL, and pptx library debug messages

DPI Quality Guidelines

Choose DPI based on your use case:

Trade-offs:

• Higher DPI : Better quality, larger file size, slower conversion
• Lower DPI : Faster conversion, smaller files, lower quality
• Sweet spot : 200-300 DPI for most presentations

Batch Processing

Process multiple PDFs efficiently:

# Convert all PDFs in directory
for pdf in *.pdf; do
  echo "Converting $pdf..."
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx"
done

# With custom DPI
for pdf in *.pdf; do
  pdf-to-pptx-tool convert "$pdf" "${pdf%.pdf}.pptx" --dpi 300
done

# With error handling
for pdf in *.pdf; do
  if pdf-to-pptx-tool -v convert "$pdf" "${pdf%.pdf}.pptx"; then
    echo "✓ Converted $pdf"
  else
    echo "✗ Failed to convert $pdf"
  fi
done

Shell Completion

Enable tab completion for faster usage:

# Bash - add to ~/.bashrc
eval "$(pdf-to-pptx-tool completion bash)"

# Zsh - add to ~/.zshrc
eval "$(pdf-to-pptx-tool completion zsh)"

# Fish - save to completions directory
mkdir -p ~/.config/fish/completions
pdf-to-pptx-tool completion fish > ~/.config/fish/completions/pdf-to-pptx-tool.fish

Benefits:

• Tab-complete commands: pdf-to-pptx-tool <TAB>
• Tab-complete options: pdf-to-pptx-tool convert --<TAB>
• Tab-complete file paths automatically

Common Issues

Issue: "poppler not found" or PDF conversion fails

# Symptom
RuntimeError: Failed to convert PDF pages: poppler not found

Solution: Install poppler system library:

# macOS
brew install poppler

# Ubuntu/Debian
sudo apt-get install poppler-utils

# Fedora
sudo dnf install poppler-utils

# Verify installation
pdftoppm -v

Issue: "File not found" error

# Symptom
✗ Error: Input PDF file not found: document.pdf

Solution:

• Verify file path is correct

• Use absolute paths if needed

• Check file permissions

  Check file exists

  ls -l document.pdf

  Use absolute path

  pdf-to-pptx-tool convert /full/path/to/document.pdf output.pptx

Issue: Output file is too large

# Symptom
Generated 50MB PPTX from 2MB PDF

Solution: Reduce DPI setting:

# Try lower DPI
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 150

# Or use default 200 DPI
pdf-to-pptx-tool convert input.pdf output.pptx

Issue: Images look blurry in PowerPoint

# Symptom
Text and diagrams appear pixelated

Solution: Increase DPI setting:

# Use higher quality
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 300

# For print quality
pdf-to-pptx-tool convert input.pdf output.pptx --dpi 600

Issue: Conversion is very slow

# Symptom
Large PDF takes minutes to convert

Solution:

1. Use DEBUG logging to see progress:

pdf-to-pptx-tool -vv convert large.pdf output.pptx

1. Consider lower DPI for faster conversion:

pdf-to-pptx-tool convert large.pdf output.pptx --dpi 150

1. Split large PDF into chunks and convert separately

Issue: Permission denied writing output file

# Symptom
PermissionError: [Errno 13] Permission denied: 'output.pptx'

Solution:

• Check directory write permissions

• Use different output location

  Write to home directory

  pdf-to-pptx-tool convert input.pdf ~/output.pptx

  Or create directory first

  mkdir -p output-dir pdf-to-pptx-tool convert input.pdf output-dir/output.pptx

Getting Help

# Tool help
pdf-to-pptx-tool --help

# Command help
pdf-to-pptx-tool convert --help

# Completion help
pdf-to-pptx-tool completion --help

# Version info
pdf-to-pptx-tool --version

Debug Workflow

When conversion fails, use this debugging workflow:

# 1. Check file exists and is readable
ls -lh document.pdf
file document.pdf

# 2. Verify poppler is installed
pdftoppm -v

# 3. Try with DEBUG logging
pdf-to-pptx-tool -vv convert document.pdf test.pptx

# 4. Try with lower DPI if memory issues
pdf-to-pptx-tool -vv convert document.pdf test.pptx --dpi 150

# 5. Check Python and dependencies
python --version
pdf-to-pptx-tool --version

Exit Codes

• 0: Success - conversion completed successfully
• 1: Error - file not found, invalid input, conversion failed, or permission denied

Output Formats

Default PowerPoint Output:

• Format : Office Open XML (.pptx)
• Aspect Ratio : 16:9 widescreen
• Slide Size : 10 inches × 5.625 inches
• Layout : One full-slide image per PDF page
• Image Format : PNG embedded in slides
• Compatibility : PowerPoint 2007+ (Windows/Mac/Online)

Console Output:

# Success
✓ Successfully converted document.pdf to slides.pptx

# Error
✗ Error: Input PDF file not found: document.pdf

Logging Output (with -v/-vv/-vvv):

[INFO] Starting PDF to PPTX conversion
[INFO] Converting document.pdf to slides.pptx (DPI: 200)
[DEBUG] Input file size: 2.45 MB
[INFO] Converted 10 pages
[DEBUG] Output file size: 12.78 MB
[INFO] Conversion completed successfully

Best Practices

1. Start with default DPI (200) : Good balance of quality and file size
2. Use verbose logging for debugging : -vv shows detailed conversion steps
3. Test with sample PDFs first : Verify quality before batch processing
4. Monitor output file sizes : Adjust DPI if files are too large
5. Batch process efficiently : Use shell loops for multiple files
6. Enable shell completion : Speeds up command-line usage
7. Keep poppler updated : Ensures compatibility with latest PDF features
8. Use absolute paths : Avoids confusion with relative paths
9. Verify prerequisites : Check poppler installation before bulk conversions
10. Handle errors gracefully : Check exit codes in scripts

Resources

• GitHub Repository : https://github.com/dnvriend/pdf-to-pptx-tool
• Python Dependencies :
  • pdf2image (PDF to image conversion)
  • python-pptx (PowerPoint file creation)
  • Pillow (Image processing)
  • Click (CLI framework)
• System Dependencies : poppler (PDF rendering engine)
• Related Tools :
  • PyPDF2 (PDF text extraction)
  • ReportLab (PDF generation)
  • pandoc (Universal document converter)

Weekly Installs

136

Repository

dnvriend/pdf-to…ptx-tool

First Seen

Jan 22, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykPass

Installed on

opencode126

gemini-cli122

codex121

github-copilot118

cursor114

kimi-cli113