lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

herramienta intermedio pythonmarkdowndocumentos

MarkItDown: convierte documentos a Markdown para tus agentes

Extrae contenido estructurado de archivos para incorporarlo a análisis de texto y flujos con modelos.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Comprueba que el intérprete python que vas a usar corresponde a Python 3.10–3.14 y que dispone de pip. Después crea un entorno y actívalo en macOS o Linux:

python -m venv .venv
source .venv/bin/activate

Instala los extras del ejemplo oficial:

pip install 'markitdown[pdf, docx, pptx]'

Convierte un PDF de prueba con el comando del README, sustituyendo la ruta por tu archivo:

markitdown path-to-file.pdf -o document.md

Abre document.md y compáralo con el original.

Comprobación

Compara el resultado con el original, especialmente títulos y tablas. Comprueba que no falten páginas o fragmentos antes de usarlo como fuente.

Si algo falla

Si falta soporte para un formato, revisa los extras instalados. Si el archivo es una imagen escaneada, consulta las opciones de OCR y sus requisitos.

Consulta el README oficial para requisitos y variantes de instalación.

ver en .md ¿Prefieres el recurso entero?

Qué es

MarkItDown es una utilidad Python de Microsoft para transformar archivos a Markdown. Está orientada a preparar información para modelos y otros procesos de análisis, conservando estructura cuando el formato lo permite.

Para qué te sirve

  • Cuando necesitas convertir un documento Office antes de entregarlo al agente.
  • Cuando quieres unificar entradas de distintos formatos en un flujo de texto.

Cómo funciona

Los conversores procesan cada formato y producen texto con títulos, listas, tablas y enlaces. Las extensiones y opciones de instalación determinan qué formatos y capacidades están disponibles.

Antes de empezar

Prepara Python 3.10–3.14, pip y los extras que correspondan a tus documentos. Algunas funciones de OCR o descripción pueden usar proveedores externos. El proceso accede a recursos con tus propios permisos.

Límites y alternativas

No conserva necesariamente toda la maquetación visual ni resuelve cualquier escaneo. Frente a extraer texto sin estructura, facilita el análisis posterior, pero debes comparar tablas y páginas importantes con el original.

Recursos