# Pymupdf

> Render PDF pages to images, extract embedded images, annotate PDFs, and perform advanced PDF inspection using pymupdf (fitz). Use for tasks such as exporting pages as PNG/JPG, extracting images embedded in a PDF, drawing annotations, redacting content, or when high-fidelity rendering is required. For text extraction, splitting, merging, or rotating PDFs, use the pypdf skill instead.

- Skill: `modbender/pymupdf` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/pymupdf`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/pymupdf/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/pymupdf

---


# pymupdf

Use `scripts/pymupdf_cli.py` for deterministic pymupdf operations instead of ad-hoc fitz snippets.

## Workflow

1. Confirm the PDF file path is accessible locally.
2. Run the desired command (export-images, extract-images, info).
3. Inspect the output directory or stdout.

## Command Guide

- Export pages as images:
  - `python scripts/pymupdf_cli.py export-images --input <file.pdf> --output-dir <dir/>`
  - Override format: `--format png` (default), `jpg`, or `ppm`.
  - Override resolution: `--dpi 300` (default: 150).
  - Restrict to specific pages: `--pages 0 1 2`.
- Extract images embedded inside a PDF:
  - `python scripts/pymupdf_cli.py extract-images --input <file.pdf> --output-dir <dir/>`
  - Optionally restrict to specific pages: `--pages 0 1 2`.
- Inspect page dimensions and basic document info:
  - `python scripts/pymupdf_cli.py info --input <file.pdf>`

## Operational Rules

- Pages are always 0-indexed in all commands.
- `export-images` renders each page as a raster image at the specified DPI.
- `extract-images` saves raw image streams embedded in the PDF (e.g. photos, logos); output filenames include page index and image index.
- Install dependency if missing: `pip install pymupdf`.
- For text extraction, splitting, merging, or rotating PDFs, use the pypdf skill instead.