# PDF To Image Preview

> Pdf To Image Preview

- Skill: `wuchubuzai2018/pdf-to-image-preview` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add wuchubuzai2018/pdf-to-image-preview`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wuchubuzai2018/pdf-to-image-preview/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: wuchubuzai2018 (https://skillmd.com/u/wuchubuzai2018)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/wuchubuzai2018/pdf-to-image-preview

---


# PDF转图片Skill

## 任务目标
- 本Skill用于：将PDF文件的每一页转换为独立的图片文件
- 能力包含：PDF文件解析、图片格式转换（PNG/JPG）、可调分辨率输出
- 触发条件：用户需要将PDF转换为图片、提取PDF页面、图片化PDF内容等场景

## 前置准备
- 依赖说明：scripts脚本所需的依赖包及版本
  ```
  pymupdf>=1.23.0
  ```

## 操作步骤
- 标准流程：
  1. **准备PDF文件**
     - 确认PDF文件路径（使用 `./` 表示当前工作目录）
     - 例如：`./document.pdf`

  2. **执行转换**
     - 调用脚本将PDF文件的每一页转换为图片
     - 命令示例：
       ```bash
       python scripts/convert_pdf_to_images.py \
         --input ./document.pdf \
         --output-dir ./images
       ```
     - 可选参数：
       - `--image-format`: 图片格式，支持 `png` 或 `jpg`，默认为 `png`
       - `--dpi`: 图片分辨率（DPI），默认为 `200`
       - `--zip`: 生成ZIP压缩包
       - `--zip-output`: ZIP压缩包输出路径（默认：images.zip）

  3. **查看输出**
     - 图片文件保存在指定的输出目录中
     - 文件命名格式：`page_001.png`、`page_002.png`...
     - 可选择是否生成ZIP压缩包

## 资源索引
- 必要脚本：见 [scripts/convert_pdf_to_images.py](scripts/convert_pdf_to_images.py)(用途与参数：PDF转图片脚本)

## 注意事项
- 输入PDF文件必须存在且可读
- 输出目录必须具有写入权限
- **PDF页数限制**：暂支持100页以内的PDF文件，超过100页请拆分后转换
- 大型PDF文件转换可能需要较长时间，请耐心等待

## 故障排查
- **脚本找不到错误**：确保在Skill目录下执行，或使用相对路径 `scripts/xxx.py`
- **Python版本问题**：确保使用Python 3.6或更高版本
- **依赖缺失**：执行 `pip install pymupdf>=1.23.0` 安装依赖
- **页数超限错误**：PDF文件超过100页，请使用PDF工具拆分为多个小文件

## 使用示例

### 示例1：基本转换（PNG格式）
```bash
python scripts/convert_pdf_to_images.py \
  --input ./report.pdf \
  --output-dir ./images
```

### 示例2：使用JPG格式
```bash
python scripts/convert_pdf_to_images.py \
  --input ./document.pdf \
  --output-dir ./images \
  --image-format jpg
```

### 示例3：高分辨率输出
```bash
python scripts/convert_pdf_to_images.py \
  --input ./document.pdf \
  --output-dir ./images \
  --dpi 300
```

### 示例4：生成ZIP压缩包
```bash
python scripts/convert_pdf_to_images.py \
  --input ./document.pdf \
  --output-dir ./images \
  --zip \
  --zip-output ./images.zip
```

### 示例5：完整配置
```bash
python scripts/convert_pdf_to_images.py \
  --input ./report.pdf \
  --output-dir ./images \
  --image-format jpg \
  --dpi 200 \
  --zip
```