Skill

pdf-to-markdown

Use when you need to convert a single PDF document into clean Markdown with extracted images

npx claudepluginhub danielrosehill/claude-code-plugins --plugin document-to-markdown

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Convert a PDF document to Markdown, detecting its content characteristics and choosing the appropriate extraction method. Extracts text, preserves structure, and saves images to a separate assets directory.

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

Stats

Stars0

Forks0

Last CommitApr 30, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

PDF to Markdown

When to use

Converting a PDF report, paper, or book to Markdown

Migrating PDF-based documentation to text format

User specifies a particular extractor preference

Inputs to gather

PDF file path (required)

Extractor choice: marker, docling, pymupdf4llm, or pdftotext (optional; defaults from config.json)

OCR flag: --ocr to force OCR on image-heavy documents (optional)

Procedure

Activate the venv at $CLAUDE_USER_DATA/document-to-markdown/venv/.

Check if the PDF has a text layer by running pdftotext -layout <pdf> - and examining output length. If minimal/empty, suggest running ocr-scanned-pdf first unless --ocr was passed.

Read config.json from $CLAUDE_USER_DATA/document-to-markdown/ to get the default extractor if not specified by the user.

Run the chosen extractor:

marker: Best for layout-rich, multi-column, or formatted documents (slower, more accurate layout)
docling: Modern layout detection; acceptable middle ground (requires setup if not in venv)
pymupdf4llm: Fast text extraction; good for text-heavy, simple PDFs
pdftotext -layout: Dumb fallback; plain text with best-effort spacing

Save output as <stem>.md next to the source PDF, where <stem> is the filename without extension.

Extract images to <stem>.assets/ directory alongside the PDF.

Provide guidance on extractor selection if the user did not specify one (recommend marker for most documents).

Output / side effects

<stem>.md file next to the source PDF, containing extracted and formatted text

<stem>.assets/ directory with any extracted images

Console output describing what was done and which extractor was used

Safety / constraints

If no text layer is detected, prompt before proceeding; offer to run OCR first

Do not overwrite existing output files without asking