pdf-to-markdown-converter

Convert PDFs to Markdown with extracted PNG images using PyMuPDF.

1|Updated Sep 4, 2025
One-click install
npx skills add https://github.com/talent-factory/dotfiles --skill pdf-to-markdown-converter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pdf-to-markdown-converter
Source: https://github.com/talent-factory/dotfiles/tree/main/agents/claude/skills/pdf-to-markdown-converter
Command: npx skills add https://github.com/talent-factory/dotfiles --skill pdf-to-markdown-converter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyMuPDF, Pillow, and includes scripts (resource) components.

What problem does it solve?

Manually extracting text and images from PDFs is a tedious, time-consuming task that locks valuable information within static documents. This skill liberates your content, transforming complex PDFs into easily editable and searchable Markdown, saving you hours of manual effort and enabling seamless content reuse.

Core Features & Use Cases

  • PDF to Markdown Conversion: Converts entire PDF documents into structured Markdown, preserving text layout.
  • Image Extraction: Automatically extracts all embedded images and saves them as PNG files, referenced within the Markdown.
  • Smart Text Correction: Automatically fixes common LaTeX umlaut encoding issues (e.g., ¨a to ä) and converts ß to ss (Swiss German style), ensuring accurate text representation.
  • Use Case: Quickly convert research papers, reports, or scanned documents into an editable format for analysis, content repurposing, or integration into knowledge bases, without losing images or struggling with formatting.

Quick Start

Convert the attached PDF 'document.pdf' to Markdown, including all images, and save the output in a new folder named 'converted_docs'.

Frequently Asked Questions about pdf-to-markdown-converter

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

FAQPage Schema
How do I convert a PDF to Markdown with images extracted?

PDF to Markdown conversion extracts all text and embedded images from PDFs, saving them as a Markdown file with a referenced images directory containing PNGs. PyMuPDF handles PDF parsing, automatically fixes LaTeX encoding issues, and preserves text layout for research papers, reports, and scanned documents.

Can I batch convert multiple PDFs to Markdown at once?

Yes, batch processing is supported across documentation pipelines and archival workflows. The Skill processes multiple PDFs in sequence, outputting separate Markdown files and image directories for each document, enabling efficient large-scale content conversion without manual repetition.

What text corrections does the PDF to Markdown converter apply?

The converter automatically fixes LaTeX umlaut encoding (¨a becomes ä) and normalizes ß to ss in Swiss German style. These corrections ensure accurate text representation when extracting content from academic papers and technical documents with special character encoding.

Does the Markdown converter preserve PDF layout and formatting?

Text layout is preserved during conversion to maintain document structure and readability. However, complex PDF formatting may be simplified to Markdown equivalents; images are extracted separately and referenced by file path within the output Markdown for cleaner, editable content.

What are the prerequisites for using PDF to Markdown conversion?

PyMuPDF (fitz) and Pillow are required dependencies. Input validation and error handling are built in; you need a valid PDF file and write permissions for output directories containing the Markdown file and extracted PNG images.

Can I use this tool with scanned documents and handwritten PDFs?

The Skill extracts text and images from PDFs containing embedded text layers. Scanned documents with OCR text layers work; purely handwritten or image-only PDFs without embedded text will extract images but no searchable text content.