pdf-to-markdown

Convert full PDF documents into Markdown with preserved formatting and images.

2|1|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/davidbeglenboyle/davids-claude-code-setup --skill pdf-to-markdown-davidbeglenboyle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-to-markdown
Source: https://github.com/davidbeglenboyle/davids-claude-code-setup/tree/main/skills/ready-to-use/pdf-to-markdown
Command: npx skills add https://github.com/davidbeglenboyle/davids-claude-code-setup --skill pdf-to-markdown-davidbeglenboyle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert entire PDF documents into clean, structured Markdown to preserve headers, formatting, tables, and embedded images for full context loading.

Core Features & Use Cases

  • Full-content extraction: preserves headers, bold/italic, lists, tables, code blocks, and images when converting PDFs to Markdown.
  • Context-heavy analysis: ideal for discussing or summarizing long documents within AI prompts or notes.
  • Versatile workflows: supports archival, documentation, and long-form analysis workflows where complete context is required.

Quick Start

Convert the target PDF to a complete Markdown document with images and a companion images directory.

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 formatting and tables?

To convert a PDF to Markdown while preserving formatting and tables, use a deterministic conversion pipeline that extracts headers, lists, tables, and embedded images into a structured Markdown document with a companion images directory.

Can I extract embedded images when converting a PDF document to Markdown?

Yes, you can extract embedded images when converting a PDF document to Markdown. The process generates a companion images directory alongside the Markdown file to store all extracted visual assets from the source document.

What is the best way to convert complex tables from a PDF to Markdown?

The best way to convert complex tables from a PDF to Markdown is to use a high-accuracy mode powered by docling, which ensures precise structural extraction of intricate table layouts during the conversion process.

How do I load an entire PDF for context-heavy AI analysis and summarization?

To load an entire PDF for context-heavy AI analysis and summarization, convert the full document into Markdown. This preserves complete formatting and structural context, making it ideal for long-form discussion within AI prompts.

Does converting a full PDF to Markdown work better than page-by-page extraction?

Yes, converting a full PDF to Markdown works better than page-by-page extraction when you need the entire document for analysis. Full-content extraction preserves complete headers and formatting context required for long-form workflows.