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)

# 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"

{
  "mcpServers": {
    "pdftomarkdown": {
      "command": "npx",
      "args": ["-y", "pdftomarkdown", "--mcp"]
    }
  }
}

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 documentation

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);