La herramienta del reel
MarkItDown es una herramienta de Microsoft para convertir documentos, incluidos PDF, a Markdown. Markdown conserva texto, títulos, listas y otras estructuras de una forma sencilla para trabajar con ellas.
La conversión no garantiza ahorrar una cantidad fija de tokens. Depende del archivo, la herramienta y el contenido que necesites. Tampoco recupera por sí sola toda la información visual de gráficos o documentos escaneados.
Ruta para quien usa Claude Code
Quiero instalar la herramienta oficial microsoft/markitdown
para convertir mis PDF locales a Markdown.
Revisa su documentación actual. Prepara un entorno de Python
separado, dentro de una carpeta nueva de trabajo. No cambies
instalaciones globales y no habilites servicios de nube ni plugins.
Explícame qué se instalará.
Convierte una COPIA del archivo [ruta de mi PDF] y guarda el
resultado como [nombre].md sin reemplazar el original.
Usa únicamente el archivo local que te indiqué.
No subas el documento a servicios externos.
Después compara títulos, cifras, tablas y páginas del original
contra el resultado. Enumera secciones omitidas o dudosas.
Si el PDF es escaneado y requiere OCR, detente y explícame opciones.
No afirmes que la conversión fue completa si no pudiste comprobarlo.
Instalación manual en Mac o Linux
Necesitas Python compatible con la versión vigente. Crea una carpeta de trabajo, abre la terminal ahí y sigue la documentación oficial. La instalación básica para PDF usa:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install 'markitdown[pdf]'
markitdown 'mi-documento.pdf' -o 'mi-documento.md'
En Windows, el paso de activación del entorno es distinto; pide a tu asistente las instrucciones para tu terminal. Trabaja con archivos tuyos y copias del original.
Después de convertir
Abre el .md con un editor de texto. Compara al menos una tabla, una cifra importante y un encabezado de cada sección. Si necesitas analizar una gráfica, conserva también la página original.
Para usarlo con IA, acompaña el archivo con una pregunta concreta: “Extrae las obligaciones del proveedor y señala la sección fuente”. Convertir el formato ayuda; subir todo sin un objetivo sigue creando trabajo innecesario.