PDF to Markdown Converter

Quick Start

uv run skills/pdf-to-markdown/scripts/convert_to_markdown.py input.pdf

~/Desktop/{filename}.md

Options

--no-llm

[Image]

--force-ocr

--page-range "0,5-10"

Common Use Cases

Convert a PDF with default settings

uv run skills/pdf-to-markdown/scripts/convert_to_markdown.py ~/Documents/report.pdf

Specify output location

uv run skills/pdf-to-markdown/scripts/convert_to_markdown.py report.pdf ~/Documents/report.md

Fast conversion (no image descriptions)

uv run skills/pdf-to-markdown/scripts/convert_to_markdown.py --no-llm report.pdf

Scanned PDF (force OCR)

uv run skills/pdf-to-markdown/scripts/convert_to_markdown.py --force-ocr scanned_doc.pdf

Extract specific pages

uv run skills/pdf-to-markdown/scripts/convert_to_markdown.py --page-range "0-5" large_report.pdf

Output

• Pure Markdown text (no embedded images)
• Tables converted to Markdown table format
• Images/charts described as text using LLM
• Clean formatting suitable for AI processing

Requirements

• GEMINI_API_KEY: Required for LLM image descriptions (loaded from 1Password)
• Use

  --no-llm

  flag if you don't have Gemini API access

First Run Note

~/.cache/marker/

Technical Details

• 31k+ GitHub stars
• Best-in-class PDF conversion accuracy
• Surya OCR for 90+ languages
• Gemini LLM integration for image understanding