📄 PDF to Markdown (PDF to MD) — Conversor rápido, privado y de código abierto

El mejor conversor de PDF a Markdown de código abierto para personas, desarrolladores y agentes de IA.
Convierte sin esfuerzo archivos PDF, Word (.docx), Excel y CSV (.xlsx, .csv) y URLs de YouTube en Markdown (.md) limpio, estructurado y eficiente en tokens.

📑 Tabla de contenidos

• ¿Por qué PDF to Markdown?

• Arquitectura y flujo de conversión

• Características principales

• Cómo usarlo (3 formas)

  • 1. Aplicación web en vivo

  • 2. CLI sin instalación (npx)

  • 3. Agente de IA y servidor MCP

• Benchmark y matriz de comparación

• Formatos compatibles

• Referencia de CLI y opciones

• API programática (Node / TypeScript)

• SEO técnico y rendimiento

• Preguntas frecuentes (FAQ)

• Licencia

Related MCP server: md-converter-mcp

🎯 ¿Por qué PDF to Markdown?

Los PDF están diseñados para la impresión visual, no para la edición ni para la computación con IA. Atrapan el contenido en blobs binarios de coordenadas fijas. Markdown (.md) es el estándar universal para:

1. 🤖 Flujos de trabajo de IA y LLM: Maximiza la densidad de tokens de los prompts para Claude, ChatGPT, Cursor y Gemini al eliminar el exceso de maquetación.

2. 🗂️ Gestión del conocimiento: Importación sin esfuerzo en Obsidian, Notion, Logseq, Roam y Apple Notes.

3. 📝 Documentación técnica: Ingestión directa en generadores de sitios estáticos como Docusaurus, VitePress, MkDocs y Astro.

4. 🌿 Control de versiones con Git: Diffs limpios línea por línea en lugar de cambios binarios opacos.

🏗️ Arquitectura y flujo de conversión

                                  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)

✨ Características principales

• 🔒 Privacidad 100% en el navegador: En la aplicación web, los documentos se convierten localmente en memoria mediante WebAssembly / JavaScript. No se sube ningún archivo a ningún servidor externo.

• ⚡ CLI sin instalación (npx): Convierte cualquier PDF, documento de Word o CSV directamente desde tu línea de comandos, sin configuración.

• 📊 Detección inteligente de tablas: Alinea automáticamente filas de varias columnas en tablas de GitHub Flavored Markdown (GFM) con barras verticales limpias (| Header | ... |).

• 🗂️ Extensibilidad multi-formato: Convierte PDF, Word (.docx), Excel/CSV (.csv) y vídeos de YouTube a Markdown.

• 🤖 Servidor nativo del Model Context Protocol (MCP): Conéctate directamente a Claude Desktop, Cursor, Windsurf y Antigravity sin escribir código.

• 🎨 Espacio de trabajo minimalista de doble panel: Editor de Markdown sin procesar en vivo junto a una vista previa HTML renderizada, con contadores de líneas, palabras y caracteres.

• 🚀 Rapidísimo: Convierte documentos estándar de varias páginas en milisegundos, sin necesidad de GPUs potentes ni modelos de varios gigabytes.

🚀 Cómo usarlo (3 formas)

1. Aplicación web en vivo (sin instalación)

Visita pdftomarkdown.fyi:

1. Arrastra y suelta cualquier archivo PDF.

2. Haz clic en Convertir a Markdown.

3. Previsualiza el documento renderizado en paralelo y haz clic en Copiar Markdown o Descargar .md.

2. CLI sin instalación (npx)

No se requiere instalación. Ejecútalo directamente en tu 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"

3. Agente de IA y servidor MCP (Claude / Cursor)

Equipa a tus asistentes de IA con capacidades de PDF to Markdown sin necesidad de escribir código.

Configuración de Claude Desktop:

Añade esta entrada a tu claude_desktop_config.json:

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

Ahora puedes pedirle a Claude:

"Lee whitepaper.pdf y conviértelo a Markdown limpio con tabla de contenidos."

📊 Benchmark y matriz de comparación

🗂️ Formatos compatibles

🛠️ Referencia de CLI y opciones

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

💻 API programática (Node / TypeScript)

Puedes importar y usar el conversor directamente dentro de tus proyectos de Node.js o TypeScript:

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

🔍 SEO técnico y rendimiento

• Palabras clave principales: PDF to Markdown, PDF to MD, conversor de PDF a Markdown, convertir PDF a Markdown.

• Palabras clave secundarias: PDF to Markdown online, conversor gratuito de PDF a Markdown, convertir archivo PDF a Markdown, extraer Markdown de PDF, Word a Markdown, YouTube a Markdown.

• Estándares técnicos: HTML5 semántico, esquemas JSON-LD de Schema.org WebSite, WebApplication y FAQPage, sitemap.xml, robots.txt.

• Cero sobrecarga en el cliente: Sin frameworks de UI pesados en el motor de análisis, hilos de trabajo WebAssembly optimizados.

❓ Preguntas frecuentes (FAQ)

¿Qué es la conversión de PDF a Markdown?

La conversión de PDF a Markdown analiza la geometría, las fuentes y las posiciones del texto dentro de archivos PDF de diseño fijo y los traduce al formato Markdown (.md) de texto plano, conservando encabezados, listas, tablas y enlaces.

¿Cómo convierto PDF a Markdown gratis?

Puedes usar la aplicación web en vivo en pdftomarkdown.fyi o ejecutar npx pdftomarkdown input.pdf -o output.md en tu terminal. Ambos son 100% gratuitos, sin registro ni suscripciones.

¿Mi documento se mantiene privado?

Sí. Cuando usas la aplicación web, todo el análisis ocurre localmente en la memoria de tu navegador. Ningún archivo ni flujo de texto se envía jamás a nuestros servidores.

¿Puedo convertir tablas de PDF a Markdown?

Sí. Nuestro motor detecta columnas de texto alineadas horizontal y verticalmente y las formatea en tablas estándar de GitHub Flavored Markdown (GFM) con barras verticales.

¿Puedo usar el resultado con ChatGPT, Claude y los LLM?

Sí. El Markdown limpio es el formato de entrada óptimo para prompts de IA y bases de datos vectoriales RAG, minimizando el uso de tokens y manteniendo la jerarquía del documento.

📄 Licencia y aviso legal

Distribuido bajo la Licencia MIT. Consulta LICENSE para más información.

Aviso legal: Todos los nombres de productos, logotipos y marcas (incluidos Microsoft, PSPDFKit/Nutrient, Marker, Claude y ChatGPT) son propiedad de sus respectivos propietarios y se utilizan aquí únicamente con fines de identificación, compatibilidad y comparación.

Copyright © 2026 PDF to Markdown