# PDF Extract

> Extract text and tables from PDF files into clean Markdown. Use when the user shares a PDF or asks to read, summarize, or convert one.

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

---


# PDF Extract

## Steps

1. Run `scripts/extract.py <file.pdf>` to get raw text and tables as Markdown.
2. Review headings; PDFs often lose structure — restore `##` sections from font-size hints in the output.
3. Return the Markdown to the user. For very long documents, summarize per section first and ask before dumping everything.

## Notes

- Scanned PDFs have no text layer; tell the user OCR is required rather than returning empty output.
- Never send the document contents to any external service.