The ultimate open-source PDF to Markdown converter for Humans, Developers, and AI Agents.
Effortlessly convert PDFs, Word (.docx), Excel & CSVs (.xlsx,.csv), and YouTube URLs into clean, structured, token-efficient Markdown (.md).
- Why PDF to Markdown?
- Architecture & Conversion Flow
- Key Features
- How to Use (3 Ways)
- Benchmark & Comparison Matrix
- Supported Formats
- CLI Reference & Options
- Programmatic API (Node / TypeScript)
- Technical SEO & Performance
- Frequently Asked Questions (FAQ)
- License
PDFs are designed for visual printing, not editing or AI computing. They trap content inside fixed-coordinate binary blobs. Markdown (.md) is the universal standard for:
- 🤖 AI & LLM Workflows: Maximizes prompt token density for Claude, ChatGPT, Cursor, and Gemini by stripping layout bloat.
- 🗂️ Knowledge Management: Effortless importing into Obsidian, Notion, Logseq, Roam, and Apple Notes.
- 📝 Technical Documentation: Direct ingestion into static site generators like Docusaurus, VitePress, MkDocs, and Astro.
- 🌿 Git Version Control: Clean line-by-line diffs instead of opaque binary changes.
INPUT SOURCE
┌──────────────────────────────┬──────────────────────────────┐
▼ ▼ ▼
📄 PDF Document 📝 Word / Excel 🎥 YouTube Link
(Local / Remote URL) (.docx, .xlsx, .csv) (Video URL / Shorts)
│ │ │
└──────────────────────────────┼──────────────────────────────┘
▼
┌──────────────────────────────────────┐
│ Unified Geometric & NLP Engine │
├──────────────────────────────────────┤
│ • Visual Reading Order Sorter │
│ • H1–H4 Typography Hierarchy │
│ • GFM Table Reconstructor │
│ • Code Block & List Parser │
│ • Link & Metadata Extractor │
└──────────────────────────────────────┘
│
▼
CLEAN MARKDOWN
┌──────────────────────────────┼──────────────────────────────┐
▼ ▼ ▼
🌐 Web UI Workspace 💻 CLI Output Stream 🤖 AI Agent Context
(Split Editor + Preview) (stdout / .md file export) (Claude / Cursor MCP)
- 🔒 100% In-Browser Privacy: In the web app, documents are converted locally in memory via WebAssembly / JavaScript. Zero files are uploaded to any external server.
- ⚡ Zero-Install CLI (
npx): Convert any PDF, Word doc, or CSV straight from your command line with no setup. - 📊 Smart Table Detection: Automatically aligns multi-column rows into clean GitHub Flavored Markdown (GFM) pipe tables (
| Header | ... |). - 🗂️ Multi-Format Extensibility: Converts PDFs, Word (
.docx), Excel/CSVs (.csv), and YouTube videos into Markdown. - 🤖 Native Model Context Protocol (MCP) Server: Connect directly to Claude Desktop, Cursor, Windsurf, and Antigravity with zero coding.
- 🎨 Minimalist Dual-Panel Workspace: Live side-by-side raw Markdown editor and rendered HTML preview with line, word, and character counters.
- 🚀 Blazing Fast: Converts standard multi-page documents in milliseconds without requiring heavy GPUs or multi-gigabyte models.
Visit pdftomarkdown.fyi:
- Drag and drop any PDF file.
- Click Convert to Markdown.
- Preview the rendered document side-by-side and click Copy Markdown or Download .md.
No installation required. Run directly in your terminal:
# Convert a local PDF file
npx pdftomarkdown research-paper.pdf -o paper.md
# Convert a Word document (.docx)
npx pdftomarkdown document.docx -o doc.md
# Convert a CSV table to GFM pipe tables
npx pdftomarkdown financials.csv -o financials.md
# Extract timestamped transcript from a YouTube video
npx pdftomarkdown "https://www.youtube.com/watch?v=dQw4w9WgXcQ" > video.md
# Convert with an automatic Table of Contents
npx pdftomarkdown manual.pdf --toc -o manual.md
# Pipe directly into an AI tool / LLM
cat quarterly-report.pdf | npx pdftomarkdown | llm "Summarize the key takeaways"Equip your AI assistants with PDF to Markdown capabilities with zero coding.
Add this entry to your claude_desktop_config.json:
{
"mcpServers": {
"pdftomarkdown": {
"command": "npx",
"args": ["-y", "pdftomarkdown", "--mcp"]
}
}
}Now you can prompt Claude:
"Read
whitepaper.pdfand convert it to clean markdown with table of contents."
| Capability | pdftomarkdown | PSPDFKit | Marker | Microsoft MarkItDown |
|---|---|---|---|---|
| Instant Live Web App | ✅ Yes (pdftomarkdown.fyi) | ❌ No | ❌ No | ❌ No |
| 100% In-Browser Privacy | ✅ Yes (0 uploads) | ❌ No | ❌ No | ❌ No |
Zero-Install CLI (npx) |
✅ Yes | ✅ Yes | ❌ (Heavy Python) | ❌ (Python pip) |
| Live Rendered Preview | ✅ Yes (Side-by-side) | ❌ No | ❌ No | ❌ No |
Word (.docx) to MD |
✅ Yes | ❌ No | ❌ No | ✅ Yes |
| Excel / CSV to GFM Table | ✅ Yes | ❌ No | ❌ No | ✅ Yes |
| YouTube Video to Transcript | ✅ Yes | ❌ No | ❌ No | ✅ Yes |
| Model Context Protocol (MCP) | ✅ Yes (Built-in) | ❌ No | ||
| Execution Speed | ⚡ < 200 ms / page | ⚡ < 200 ms / page | 🐢 5–20 s (GPU) | ⚡ < 500 ms / page |
| Hardware Overhead | 🪶 Featherweight (JS) | 🪶 Featherweight | 🐘 Giant (10GB+ PyTorch) | 🐍 Python Env |
| Format | Extension | Output Style |
|---|---|---|
| PDF Documents | .pdf |
Headings (H1–H4), lists, GFM tables, links, code blocks |
| Word Documents | .docx |
Headings, bold/italic, bullet lists, clean links |
| Excel & CSV | .csv, .tsv, .xlsx |
GitHub Flavored Markdown (GFM) pipe tables |
| YouTube URLs | https://youtube.com/... |
Timestamped transcript (00:00), description, and metadata |
| Plain Text & Code | .txt, .json, .xml |
Formatted code fences & readable Markdown blocks |
pdftomarkdown — The universal document to Markdown converter.
Usage:
npx pdftomarkdown <file-or-url> [options]
Options:
-o, --output <file> Write output directly to a file (.md)
--toc Automatically generate a Table of Contents
--no-tables Disable automatic GFM table detection
--mcp Start Model Context Protocol (MCP) server
-v, --version Show current version
-h, --help Show help documentationYou can import and use the converter directly inside your Node.js or TypeScript projects:
import { convertPdfToMarkdown, convertAnyToMarkdown } from 'pdftomarkdown';
// Convert a PDF buffer or file
const markdown = await convertPdfToMarkdown(pdfBuffer, {
includeToc: true,
detectTables: true,
preservePageBreaks: true,
});
console.log(markdown);- Primary Keywords: PDF to Markdown, PDF to MD, PDF to Markdown converter, convert PDF to Markdown.
- Secondary Keywords: PDF to Markdown online, free PDF to Markdown converter, convert PDF file to Markdown, extract Markdown from PDF, Word to Markdown, YouTube to Markdown.
- Technical Standards: Semantic HTML5, Schema.org
WebSite,WebApplication, andFAQPageJSON-LD schemas, sitemap.xml, robots.txt. - Zero Client Overhead: No heavy UI frameworks on the parser engine, optimized WebAssembly worker threads.
PDF to Markdown conversion parses the geometry, fonts, and text positions inside fixed-layout PDF files and translates them into plain-text Markdown (.md) format, preserving headings, lists, tables, and links.
You can use the live web app at pdftomarkdown.fyi or run npx pdftomarkdown input.pdf -o output.md in your terminal. Both are 100% free with no registration or subscriptions.
Yes. When using the web app, all parsing occurs locally in your browser's memory. No files or text streams are ever sent to our servers.
Yes. Our engine detects horizontally and vertically aligned text columns and formats them into standard GitHub Flavored Markdown (GFM) pipe tables.
Yes. Clean Markdown is the optimal input format for AI prompts and RAG vector databases, minimizing token usage while maintaining document hierarchy.
Distributed under the MIT License. See LICENSE for more information.
Disclaimer: All product names, logos, and brands (including Microsoft, PSPDFKit/Nutrient, Marker, Claude, and ChatGPT) are property of their respective owners and are used here solely for identification, compatibility, and comparative purposes.
Copyright © 2026 PDF to Markdown