Skip to main content
skill CX Codex

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

pdf-to-markdown transcribes scanned and image-based PDFs into formatted Markdown files saved in the same directory as the source document.

no license 5 installs ★ 4 updated 2026-10-22

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

What pdf-to-markdown does

This skill relies on vision capabilities to read pages directly instead of calling separate OCR APIs. It first inspects page totals with pdfinfo. When a document spans 10 or more pages, it splits the file into 4-page batches with qpdf and handles them simultaneously through Task agents.

The resulting .md file retains headings, lists, original diacritics, and handwritten notes in italics. Strikethrough syntax marks crossed-out phrases. Once merging finishes, temporary files are cleaned up automatically.

Without qpdf installed on your machine, processing documents with 10 or more pages will fail during the chunking phase.

What it helps with

  • extract text from scanned or image-based PDF files
  • convert multi-page documents in parallel 4-page batches
  • preserve handwritten edits and crossed-out notes in markdown
  • format raw scanned pages into clean heading and list structures

Example prompts for the agent

  • Transcribe scanned_contract.pdf into a markdown file
  • Convert the image document history_archive.pdf to markdown
  • Extract text from records.pdf while preserving handwritten annotations

How to install pdf-to-markdown

1Skills CLI (Vercel)

npx skills add lttr/dotfiles --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 to install pdf-to-markdown in Claude Code?

Run npx skills add lttr/dotfiles --skill pdf-to-markdown -a claude-code in your terminal.

What does pdf-to-markdown do?

It reads PDF pages visually via assistant tools, transcribes the content, and outputs a formatted .md file right next to the source.

Which dependencies are required?

You need pdfinfo to count pages and qpdf to break down documents that contain 10 or more pages.

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 aliceisjustplaying pdf-to-markdown loads an entire PDF into the agent's context as structured Markdown with tables and images instead of grep-sized fragments. CX Codex +1 14installs pdf-tools oakoss pdf-tools — a skill for Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI that covers the full PDF lifecycle: text and table extraction, generation, modification, form filling and encryption. CX Codex +1 186installs 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 OCR Extraction claude-office-skills PDF OCR Extraction is a Claude Code skill that reads text from scanned documents and image-based PDFs. Ask it to recognize pages, make a PDF searchable, or process a batch of files. CX Codex +1 6,000installs

Project sponsors

Companies that keep this analytics open