How do I install the PDF To Markdown Converter skill?

Run npx skillmds@latest add tomevault-io/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. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. 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?

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

PDF To Markdown Converter by tomevault-io

Name: PDF To Markdown Converter
Author: tomevault-io

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.

tomevault-io Updated Sep 17, 2026

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---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## OverviewThis 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## PrerequisitesEnsure PyMuPDF is installed (installs in ~10-20 seconds):```bashpip install PyMuPDF --break-system-packages```Optional for better image format support:```bashpip install Pillow --break-system-packages```## Usage Workflow1. **Receive PDF file**: User provides the PDF file path2. **Validate input**: Check that the file exists and is a valid PDF3. **Run conversion**: Execute [pdf_converter.py](scripts/pdf_converter.py) with the PDF path4. **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```bashpython 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 HandlingIf 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---> Converted and distributed by [TomeVault](https://tomevault.io/claim/talent-factory) — claim your Tome and manage your conversions.

Frequently asked questions