pdf-to-md

Convert mixed PDFs with text, images, and charts into Markdown.

Updated Feb 5, 2026
One-click install
npx skills add https://github.com/taturou/pdf-to-md-skill --skill pdf-to-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-to-md
Source: https://github.com/taturou/pdf-to-md-skill/tree/main/.codex/skills/pdf-to-md
Command: npx skills add https://github.com/taturou/pdf-to-md-skill --skill pdf-to-md

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdf2image, pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Converts mixed PDFs containing text, images, and charts into AI-friendly Markdown for easier understanding, indexing, and processing.

Core Features & Use Cases

  • PDF type detection, text extraction, OCR to produce consistent Markdown.
  • Batch processing to handle multiple PDFs in one run, with chunking for large documents.
  • Structured output that preserves meaning (headings, tables, figures) and supports downstream AI workflows.

Quick Start

Convert a batch of PDFs by running the pipeline to output one Markdown file per document with images in an images/ directory.

Frequently Asked Questions about pdf-to-md

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

FAQPage Schema
How do I convert mixed PDFs with images and charts into Markdown?

Batch processing converts mixed PDFs into Markdown by running an end-to-end pipeline that includes text extraction, OCR, and figure handling. It preserves headings, tables, and figures to ensure structured, AI-friendly output for downstream indexing.

What is the best way to batch process multiple PDFs for AI indexing?

Batch processing multiple PDFs for AI indexing is handled through chunked job management that processes many documents with varying layouts in one run. This outputs one Markdown file per document with linked images for searchability.

Does this PDF to Markdown conversion require image processing dependencies?

PDF to Markdown conversion requires image processing dependencies including pdf2image and pillow. These libraries enable the pipeline to convert document pages into images for OCR and figure handling before schema-driven Markdown generation.

How does OCR handle text extraction from PDFs with varying layouts?

OCR handles text extraction from PDFs with varying layouts by first converting pages to images, then applying detection and extraction algorithms. This mechanism ensures consistent Markdown generation while preserving meaningful structure across different document types.

Can I preserve tables and figures when turning PDF documents into Markdown?

You can preserve tables and figures when turning PDF documents into Markdown through schema-driven generation. The pipeline handles figure extraction by placing images in an images directory and maintaining meaningful structural elements within the text.

What are the limitations of chunking large documents during PDF to Markdown conversion?

Chunking large documents during PDF to Markdown conversion manages memory and processing limits by breaking jobs into smaller segments. While this handles large files effectively, extremely complex layouts may still require manual review for accurate structural preservation.