pdf2md-uv 0.1.0

Fast local PDF to Markdown converter — powered by pymupdf4llm & uv

pdf2md-uv

Fast local PDF to Markdown converter — powered by pymupdf4llm and distributed via uv.

pdf2md paper.pdf          → paper.md
pdf2md slides/            → convert all PDFs in directory

Why pdf2md-uv?

There are many tools named pdf2md, but most are:

• ❌ Browser-based apps (no CLI)
• ❌ Cloud APIs (data privacy risk)
• ❌ Heavy ML models (need GPU)

pdf2md-uv is different:

• ✅ Modern: Packaged with uv — the new standard for Python tooling
• ✅ Fast: Seconds for typical documents
• ✅ Private: 100% local, no cloud API calls
• ✅ Smart: Auto-detects scanned pages and uses built-in RapidOCR

Install

Requires uv:

uv tool install pdf2md-uv

That's it. No pip install, no virtualenv setup, no dependency conflicts.

Usage

# Single file
pdf2md input.pdf

# Custom output path
pdf2md input.pdf -o custom.md

# Batch convert directory
pdf2md papers/

# Quiet mode (for scripting)
pdf2md input.pdf -q

How it works

pdf2md-uv wraps pymupdf4llm to provide a zero-config CLI:

1. Text-based PDFs: Direct text extraction (100% accurate)
2. Scanned PDFs: Automatic OCR using RapidOCR (PP-OCRv4 model)

Everything runs locally on your CPU.

Comparison

Tool	Tech	Offline?	Notes
pdf2md-uv (this)	pymupdf4llm + RapidOCR	✅	Fast, local, uv-packaged
mrmps/pdf2md	Next.js browser app	✅	Frontend only
link2004/pdf2md	Mistral AI API	❌	Cloud dependency
mathinml/pdf2md	Qwen2.5-VL (3B)	✅	Needs GPU

License

MIT