alejo.santanna/recursos/markitdownGratis
Watch7.6kFork36.9k
GUIA.md4 secciones · 5 prompts

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:

Repositorio oficial en GitHub
github.com/microsoft/markitdown
Abrir en GitHub ↗

Este es el link que le pasás a Claude, no el de esta página.

Pegar en Claude Code
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.

Pegar en Claude Code
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.
Nota
Por qué conviene

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.

Pegar en Claude Code
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.

Pegar en Claude Code
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.

Pegar en Claude Code
Convertí este PDF a Markdown con MarkItDown y decime cuánto pesaba antes y después de la conversión.

04Problemas reales al probarlo

Si instalás sin las dependencias opcionales
pip install markitdown

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.

Ojo
Los pdfs con texto en columnas no siempre salen limpios

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
Seguí con estos
RecursosTrabajar conmigo

¿Qué estás precisando ahora mismo?

Automatizar procesos en mi negocio.
→
Aprender de IA.consultorías y asesorías
→
Un proyecto más grande. Tengo presupuesto.agentes, sistemas, una construcción completa
→

Se abre WhatsApp con el mensaje ya escrito. Lo hablamos por ahí y coordinamos una llamada.