Skip to main content
skill CX Codex

pdf-to-markdown · aliceisjustplaying — Claude Code skill: what it does, how to install

pdf-to-markdown loads an entire PDF into the agent's context as structured Markdown with tables and images instead of grep-sized fragments.

no license 14 installs ★ 5 updated 2025-12-22

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add aliceisjustplaying/claude-resources-monorepo --skill pdf-to-markdown -a claude-code
Open on GitHub

What pdf-to-markdown does

The skill runs IBM's Docling model to turn a whole PDF into Markdown: font size drives heading levels, the TableFormer model handles table extraction, and lists, multi-column layout and code blocks come through intact. Images get pulled out separately into an images/ folder next to the resulting .md file, linked from the text with relative paths, and listed in a summary table at the bottom.

It runs inside its own environment at ~/.claude/skills/pdf-to-markdown/.venv/, built with uv and the pymupdf, docling and docling-core packages on first use. Output gets cached by file content hash under ~/.cache/pdf-to-markdown/, so repeat requests for the same file come back instantly, while the first pass takes longer because Docling has to pull down its models.

Scanned PDFs need Tesseract OCR installed, or text extraction quality drops. When the markdown output references a figure or chart, the agent is meant to open that image file with Read on its own rather than just repeating the caption.

What it helps with

  • pull a full PDF into an agent's working context
  • extract tables from a PDF without breaking their structure
  • get images out of a PDF with links back to the surrounding text
  • process a scanned document through OCR
  • skip re-converting a PDF that was already processed

Example prompts for the agent

  • Load the whole document.pdf into context and summarize the main sections
  • Convert report.pdf to Markdown with its tables and images
  • Read paper.pdf in full and describe what the figures show

How to install pdf-to-markdown

1Skills CLI (Vercel)

npx skills add aliceisjustplaying/claude-resources-monorepo --skill pdf-to-markdown -a claude-code

2Manually: put the files in place

~/.claude/skills/pdf-to-markdown/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pdf-to-markdown/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pdf-to-markdown

How do I install pdf-to-markdown in Claude Code?

Run npx skills add aliceisjustplaying/claude-resources-monorepo --skill pdf-to-markdown -a claude-code; the skill lands at ~/.claude/skills/pdf-to-markdown/SKILL.md.

What does pdf-to-markdown do?

It converts a full PDF into structured Markdown, keeping headings, tables, lists and extracted images, so the whole document can be loaded into an agent's context in one pass.

What does pdf-to-markdown need for scanned PDFs?

Scanned documents require Tesseract OCR to be installed, otherwise text extraction quality drops.

Similar skills

All skills for Writing and docs →

pdf-to-markdown by other authors comes first.

pdf-to-markdown PSPDFKit-labs pdf-to-markdown turns a PDF into structured Markdown with headings, tables, lists and reading order intact. Handy when an agent needs the text of a document to work with. CX Codex +1 870installs pdf-to-markdown claesbackman pdf-to-markdown splits PDF documents into page blocks and converts them to Markdown, automatically trimming bibliographies. CX Codex +1 ★ 579repo stars pdf-to-markdown lttr pdf-to-markdown transcribes scanned and image-based PDFs into formatted Markdown files saved in the same directory as the source document. CX Codex +1 5installs markdown-converter steipete markdown-converter converts documents, spreadsheets, PDF, media, and structured data into Markdown via uvx without manual parser setup. CX Codex +1 346installs PDF to Markdown dudko-dev The PDF to Markdown MCP server connects an AI agent to the pdf2md API and prepares requests to turn PDFs into Markdown. Sign in with a dudko.dev account to use it. CX Codex +1 oma-pdf First Fluke oma-pdf converts PDF documents into structured Markdown while preserving tables, headings, and lists. Runs when preparing files for LLM context or RAG pipelines. CX Codex +1 ★ 1,472repo stars pdf-toolkit-mcp AryanBV pdf-toolkit-mcp — an MCP server with 22 tools to read, build, encrypt and merge PDFs. Renders pages to images so the model can read scanned documents with no text layer. CX Codex +1 ★ 12repo stars pdf-mcp jztan Gives your agent access to one PDF or a whole folder: hybrid search, reading only the pages that matter, tables and OCR. CX Codex +1 ★ 174repo stars pdf-extraction claude-office-skills pdf-extraction extracts tables and text from PDF files using pdfplumber. It helps when you need to pull tabular data into DataFrames or parse invoices. CX Codex +1 9,600installs

From the same set2

Project sponsors

Companies that keep this analytics open