MarkItDown
Convierte PDFs y otros documentos a Markdown liviano, para que las IAs los lean gastando muchos menos tokens.
01Instalalo con Claude Code
No hace falta que sepas nada de terminal. Abrí Claude Code en cualquier carpeta y pegale esto — el link del repo va incluido adentro, por si el prompt viaja solo:
Este es el link que le pasás a Claude, no el de esta página.
Quiero instalar MarkItDown, la herramienta de Microsoft que convierte PDFs y otros documentos a Markdown (repo: https://github.com/microsoft/markitdown). Primero verificá que tengo Python 3.10 o superior con "python --version"; si no lo tengo, avisame antes de seguir. Después instalá el paquete completo con pip install "markitdown[all]" (los corchetes necesitan comillas para que no fallen). Confirmá que quedó andando corriendo "markitdown --version" y mostrame el resultado. Si tengo algún PDF de prueba en la carpeta, convertilo con markitdown "archivo.pdf" -o "archivo.md" y decime cuánto más liviano quedó el Markdown comparado con el PDF original.
Claude Code corre los comandos por vos y te avisa cuando termina. La instalación completa (con soporte para PDF, Word, Excel, PowerPoint, audio y más) tarda alrededor de un minuto y medio con una conexión normal.
02Instalá también la skill (opcional, recomendada)
Con MarkItDown instalado, tenés que acordarte de pedirle a Claude Code que lo use cada vez. Si además instalás esta skill personal, Claude Code va a convertir cualquier PDF que le compartas antes de leerlo, sin que se lo tengas que pedir.
Quiero crear una skill personal en Claude Code para que uses MarkItDown automáticamente. Creá el archivo ~/.claude/skills/pdf-to-markitdown/SKILL.md (en Windows, %USERPROFILE%\.claude\skills\pdf-to-markitdown\SKILL.md) con frontmatter de name y description, y contenido que indique lo siguiente: antes de leer cualquier PDF, Word, Excel, PowerPoint o HTML que yo te comparta, convertilo primero a Markdown corriendo markitdown "archivo" -o "archivo.md" y leé ese .md en vez del original, para gastar muchos menos tokens. Si markitdown falla por una dependencia faltante, avisame en vez de leer el original directamente. Si el archivo ya es texto plano o un formato que MarkItDown no soporta, leelo directo. Confirmame cuando la skill quede creada.
Un PDF de diapositivas real que probamos pesaba 1.7 MB; convertido a Markdown quedó en 11.9 KB — un 99% menos, con todo el texto intacto. Eso es lo que la skill te ahorra sin pensarlo cada vez.
03Usalo con Claude Code
Si instalaste la skill de la página anterior, Claude Code convierte el PDF solo apenas se lo menciones. Si no, pedíselo explícito como en estos ejemplos.
Analizar un PDF puntual
Le pasás la ruta de un PDF y le pedís que lo lea, resuma o explique. Con la skill puesta, lo convierte a Markdown antes de leerlo sin que lo tengas que aclarar.
Leé este PDF y hacéme un resumen de los puntos principales: C:\ruta\al\archivo.pdf
Convertir varios PDFs de una carpeta
Para lotes, mejor pedirlo explícito así Claude Code corre MarkItDown sobre cada archivo.
Convertí a Markdown todos los PDFs de la carpeta C:\ruta\a\la\carpeta con MarkItDown, guardando cada .md al lado del PDF original.
Confirmar cuánto se ahorró
MarkItDown reduce mucho el tamaño porque descarta el formato visual y se queda solo con el texto. Sirve para confirmar que valió la pena antes de mandarle documentos grandes a una IA.
Convertí este PDF a Markdown con MarkItDown y decime cuánto pesaba antes y después de la conversión.
04Problemas reales al probarlo
a secas instala el paquete, pero al convertir un PDF tira este error exacto: "PdfConverter recognized the input as a potential .pdf file, but the dependencies needed to read .pdf files have not been installed". Se soluciona reinstalando con pip install "markitdown[pdf]" o pip install "markitdown[all]" . El prompt de la página 2 ya instala la versión completa, así que si lo seguiste tal cual no te va a pasar.
En un PDF con texto distribuido en columnas (una diapositiva de Modelo Relacional que probamos), MarkItDown duplicó letras dentro de algunas palabras y armó tablas Markdown que no existían en el original — intenta detectar tablas por la posición de las palabras en la página, y ahí se confunde con columnas de texto corrido. En PDFs de una sola columna, como la mayoría de las diapositivas o documentos de texto simple, la conversión sale limpia. Si el PDF tiene mucho texto en columnas o tablas complejas, conviene revisar el .md a ojo antes de confiar en él del todo.
¿Lo querés a medida para tu negocio?
Armo sistemas y agentes de IA, y doy consultorías y asesorías para equipos en Latinoamérica y España.
Trabajar conmigo