How do I install the PDF To Markdown Converter skill?

Run npx skillmds add majiayu000/pdf-to-markdown-converter in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is PDF To Markdown Converter safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with PDF To Markdown Converter?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is PDF To Markdown Converter free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published PDF To Markdown Converter?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

PDF To Markdown Converter by majiayu000

Name: PDF To Markdown Converter
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

PDF To Markdown Converter

Converts PDF files to Markdown format using PyMuPDF, extracting text content and embedded images. Fast and lightweight. Automatically fixes LaTeX umlauts (¨a → ä, etc.) and converts ß to ss (Swiss German). Use when converting PDFs to Markdown, extracting document content, or processing PDF files for text analysis. Generates one .md file and 0..n .png files for images.

majiayu000 dbf0c82 2 files · 3.0 KB Updated Sep 9, 2026 567 repo stars

File contents

PDF to Markdown Converter

Overview

This skill converts PDF files to Markdown format using the PyMuPDF (fitz) library. It extracts text content and saves embedded images as separate PNG files. This is a fast and lightweight alternative to Docling.

Special Features:

✅ Automatically fixes LaTeX-style umlauts (¨a, ¨o, ¨u → ä, ö, ü)
✅ Converts ß to ss (Swiss German style)
✅ Corrects common LaTeX encoding issues
✅ Preserves text layout
✅ Extracts all images as PNG files

Prerequisites

Ensure PyMuPDF is installed (installs in ~10-20 seconds):

pip install PyMuPDF --break-system-packages

Optional for better image format support:

pip install Pillow --break-system-packages

Usage Workflow

Receive PDF file: User provides the PDF file path
Validate input: Check that the file exists and is a valid PDF
Run conversion: Execute pdf_converter.py with the PDF path
Output organization:
- Markdown file: <original_name>.md
- Images folder: <original_name>_images/ containing PNG files
- Images are referenced in the Markdown with relative paths

Conversion Command

python scripts/pdf_converter.py <input.pdf> [output_dir]

Parameters:

input.pdf: Path to the source PDF file
output_dir: (Optional) Output directory. Defaults to current directory

Output Structure

output_dir/
├── document.md              # Converted markdown content
└── document_images/         # Extracted images (if any)
    ├── image_001.png
    ├── image_002.png
    └── ...

Error Handling

If conversion fails:

Check PDF is not corrupted or password-protected
Verify Docling installation
Ensure sufficient disk space for image extraction
Review console output for specific error messages

Best Practices

Large PDFs may take time to process - inform user
Preview the first page for complex documents to verify quality
For batch processing, process files sequentially to avoid memory issues
Preserve original PDF files - never overwrite source documents

---name: pdf-to-markdown-converterdescription: Converts PDF files to Markdown format using PyMuPDF, extracting text content and embedded images. Fast and lightweight. Automatically fixes LaTeX umlauts (¨a → ä, etc.) and converts ß to ss (Swiss German). Use when converting PDFs to Markdown, extracting document content, or processing PDF files for text analysis. Generates one .md file and 0..n .png files for images.--- # PDF to Markdown Converter ## Overview This skill converts PDF files to Markdown format using the PyMuPDF (fitz) library. It extracts text content and saves embedded images as separate PNG files. This is a fast and lightweight alternative to Docling. **Special Features:** - ✅ Automatically fixes LaTeX-style umlauts (¨a, ¨o, ¨u → ä, ö, ü) - ✅ Converts ß to ss (Swiss German style) - ✅ Corrects common LaTeX encoding issues - ✅ Preserves text layout - ✅ Extracts all images as PNG files ## Prerequisites Ensure PyMuPDF is installed (installs in ~10-20 seconds): ```bash pip install PyMuPDF --break-system-packages ``` Optional for better image format support: ```bash pip install Pillow --break-system-packages ``` ## Usage Workflow 1. **Receive PDF file**: User provides the PDF file path 2. **Validate input**: Check that the file exists and is a valid PDF 3. **Run conversion**: Execute [pdf_converter.py](scripts/pdf_converter.py) with the PDF path 4. **Output organization**: - Markdown file: `<original_name>.md` - Images folder: `<original_name>_images/` containing PNG files - Images are referenced in the Markdown with relative paths ## Conversion Command ```bash python scripts/pdf_converter.py <input.pdf> [output_dir] ``` Parameters: - `input.pdf`: Path to the source PDF file - `output_dir`: (Optional) Output directory. Defaults to current directory ## Output Structure ``` output_dir/ ├── document.md # Converted markdown content └── document_images/ # Extracted images (if any) ├── image_001.png ├── image_002.png └── ... ``` ## Error Handling If conversion fails: - Check PDF is not corrupted or password-protected - Verify Docling installation - Ensure sufficient disk space for image extraction - Review console output for specific error messages ## Best Practices - Large PDFs may take time to process - inform user - Preview the first page for complex documents to verify quality - For batch processing, process files sequentially to avoid memory issues - Preserve original PDF files - never overwrite source documents

Frequently asked questions