pdf-to-markdown

Convert entire PDFs into structured Markdown with Docling.

5|1|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/aliceisjustplaying/claude-resources-monorepo --skill pdf-to-markdown-aliceisjustplaying
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-to-markdown
Source: https://github.com/aliceisjustplaying/claude-resources-monorepo/tree/main/skills/pdf-to-markdown
Command: npx skills add https://github.com/aliceisjustplaying/claude-resources-monorepo --skill pdf-to-markdown-aliceisjustplaying

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pymupdf, docling, docling-core, and includes scripts (resource) components.

What problem does it solve?

This Skill converts entire PDFs into clean, structured Markdown that can be loaded into context for analysis, preserving formatting and embedded content.

Core Features & Use Cases

  • Full-document extraction: Convert all text, headers, tables, lists, and images from a PDF into Markdown for context loading.
  • Table and image handling: Uses IBM Docling's TableFormer AI model for accurate tables and extracts images to a cache for reference.
  • Use Case: Ideal when you need the entire document content available for in-context analysis or long-form review.

Quick Start

Run: python pdf_to_md.py document.pdf to generate document.md with images placed alongside.

Frequently Asked Questions about pdf-to-markdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a PDF to Markdown while preserving tables and images?

You can convert PDF to Markdown with tables and images by using a tool that applies IBM Docling's TableFormer model. This approach extracts full document text, structures tables natively, and saves embedded images to a persistent cache for reference.

What is the best way to extract full-context Markdown from a PDF for long-form analysis?

Full-context Markdown extraction converts entire PDFs into structured text, preserving headers, lists, tables, and images. This ensures complete document structure is loaded into context, preventing information loss during long-form analysis or summarization.

Does converting PDF to Markdown with Docling require a persistent cache?

Yes, converting PDF to Markdown with Docling requires a persistent cache. This cache preserves extracted images and structural outputs across sessions, ensuring that embedded content and document formatting remain available for later reference.

Can I extract tables from a PDF into Markdown without losing formatting?

Yes, extracting tables from a PDF into Markdown without losing formatting is possible. By utilizing IBM Docling's TableFormer AI model, the conversion process accurately captures table structures and outputs them as native Markdown tables.

How do I run a full PDF to Markdown conversion from the command line?

To run a full PDF to Markdown conversion from the command line, execute the conversion script with your target PDF file. This generates a Markdown file alongside extracted images, making the entire document content available for immediate analysis.

Why does my PDF to Markdown conversion lose embedded images and document structure?

PDF to Markdown conversions lose embedded images and structure when using basic text extraction. Applying a full-context extraction approach with pymupdf and Docling preserves formatting, extracts images to cache, and maintains complete document hierarchy.