PDF to Markdown

Extracts a whole PDF into clean, structured Markdown with real headers, tables, and images.

Tested · Works

Test report

Verdict
Tested · Works
Score
9.6/10
Tested
Jul 14, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 4203aab

Ran the bundled pymupdf4llm script on a test PDF with a table, bold/italic text, and a bullet list: it produced real markdown headers, a piped table, and preserved bold/italic formatting, while the harness's own default PDF-read fell back to one undifferentiated block of plain text with zero structure markers.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 9/10
  • Docs & honesty 5/5

What PDF to Markdown does

A CLI-backed skill that converts an entire PDF to Markdown using PyMuPDF/pymupdf4llm (or Docling for high-accuracy tables), preserving headers, bold/italic, multi-column reading order, tables, and extracted images, with aggressive content-hash caching. It triggers when a user wants the 'whole PDF' or 'entire document' loaded into context rather than a grep/search or page-by-page approach.

How to install PDF to Markdown

git clone https://github.com/aliceisjustplaying/claude-skill-pdf-to-markdown
cd claude-skill-pdf-to-markdown
mkdir -p ~/.claude/skills
cp -r . ~/.claude/skills/pdf-to-markdown

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger PDF to Markdown

  • /pdf-to-markdown Extracts a whole PDF into clean, structured Markdown with real headers, tables, and images.

It also activates on plain-language prompts like these:

  • Load this entire PDF into context, not just search it
  • Convert this whole PDF report into clean markdown with tables
  • Extract all the text and tables from this PDF, preserve formatting

Frequently asked questions

Is the PDF to Markdown skill free?
Yes. The skill itself is free from aliceisjustplaying/claude-skill-pdf-to-markdown. SkillProof publishes the install command and an independent test verdict at no cost.
Does PDF to Markdown work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 14, 2026. Verdict: Tested · Works. Ran the bundled pymupdf4llm script on a test PDF with a table, bold/italic text, and a bullet list: it produced real markdown headers, a piped table, and preserved bold/italic formatting, while the harness's own default PDF-read fell back to one undifferentiated block of plain text with zero structure markers.
What is the PDF to Markdown SkillProof Score?
9.6/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 9/10, docs & honesty 5/5.
How do I install PDF to Markdown?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use PDF to Markdown with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.