# Instrucciones para el agente: MarkItDown: convierte documentos a Markdown para tus agentes

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.

- Dificultad: intermedio
- Proyecto: https://github.com/microsoft/markitdown (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/markitdown-document-converter

---

## 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:

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

Instala los extras del ejemplo oficial:

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

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

```sh
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](https://github.com/microsoft/markitdown#readme) para requisitos y variantes de instalación.