skills.rest
SillyHippy
SillyHippyCOMMUNITY
Explore all skills by this author →
GitHub

pdf-to-markdown

Convert PDF files to Markdown format with preserved structure and extracted images.

Updated Sep 5, 2026
Search Tags:#pdf#markdown#document conversion#convert#image extraction#pymupdf4llm
One-click install
npx skills add https://github.com/SillyHippy/zo-skills --skill pdf-to-markdown-sillyhippy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pdf-to-markdown
Source: https://github.com/SillyHippy/zo-skills/tree/main/skills/zo-pdf-to-markdown
Command: npx skills add https://github.com/SillyHippy/zo-skills --skill pdf-to-markdown-sillyhippy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pymupdf4llm.

What problem does it solve? PDF documents are difficult to edit, search, and reuse in text-based workflows. This Skill converts PDF files into Markdown so the content can be edited, versioned, and integrated into documentation pipelines. ## Core Features & Use Cases - PDF to Markdown Conversion: Uses pymupdf4llm to convert PDF content into Markdown while preserving document structure and formatting. - Page Chunking and Image Extraction: Separates output by page and extracts embedded images alongside the text. - Use Case: A researcher receives a PDF report and needs to quote and reorganize its sections in a notes app. The Skill converts the PDF into a Markdown file saved next to the original, ready for editing. ## Quick Start Convert my PDF file report.pdf into a Markdown file and tell me where it was saved.

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 file to Markdown in Python?▼

Use pymupdf4llm's to_markdown function with the PDF path to produce Markdown text, then write the result to a .md file. Enable page_chunks to separate pages and write_images to extract embedded images.

What Python library converts PDF to Markdown?▼

pymupdf4llm is a Python library built on PyMuPDF that converts PDF documents to Markdown while preserving structure and formatting. Install it with pip install pymupdf4llm.

Does PDF to Markdown conversion work on scanned documents?▼

No, scanned PDFs contain images of text rather than a text layer, so direct conversion produces poor results. OCR tools are recommended for scanned documents instead of pymupdf4llm.

Can I extract images from a PDF during Markdown conversion?▼

Yes, set write_images=True when calling pymupdf4llm.to_markdown to extract and include images from the PDF alongside the converted Markdown text.

How do I keep page breaks when converting PDF to Markdown?▼

Pass page_chunks=True to pymupdf4llm.to_markdown so the output is separated by page, preserving the original document's page boundaries in the Markdown result.

Related Skills

Explore More Content & Communication Skills→
flaz78flaz78
9

pdf_reader

Extract readable text from selectable-content PDF documents.

Community
Intermediate
microsoftmicrosoft
2.9k

wiki-vitepress

Package wiki Markdown into a VitePress static site with dark theme and Mermaid diagrams.

Official
Advanced
AIAsysAIAsys
21

PaddleOCR 文档提取

Convert scanned PDFs and images to Markdown while preserving layout, tables, and image positions.

Official
Intermediate
nadicodeainadicodeai

ocr-and-documents

Extract and convert PDF, scanned document, and image text to plain text or Markdown using OCR and pymupdf/marker-pdf.

Official
Intermediate