Convierte PDF y Excel a texto para la IA (MarkItDown)

Pasos

1. Comprueba tu Python

python3 --version

En Windows:

py --version

Si sale 3.10 o más, sigue. Si sale 3.9 o te dice que no existe, instala la última versión desde python.org/downloads (instalador normal, siguiente, siguiente). En Windows marca la casilla de añadir Python al PATH.

Al acabar: ves Python 3.12.x o similar.

2. Crea una carpeta con su propio entorno

Así no tocas nada del sistema. En Mac:

mkdir ~/bar-datos && cd ~/bar-datos
python3 -m venv .venv
source .venv/bin/activate

En Windows:

mkdir $HOME\bar-datos; cd $HOME\bar-datos
py -m venv .venv
.venv\Scripts\activate

Si en Mac python3 sigue siendo el 3.9, usa el nuevo por su nombre: python3.13 -m venv .venv. Si PowerShell dice que la ejecución de scripts está deshabilitada, ejecuta una vez Set-ExecutionPolicy -Scope CurrentUser RemoteSigned y vuelve a activar.

Al acabar: delante de la línea de la terminal aparece (.venv).

3. Instala MarkItDown

pip install 'markitdown[all]'

En PowerShell, igual pero con comillas dobles: pip install "markitdown[all]". Si solo vas a convertir PDF y Excel, te vale pip install 'markitdown[pdf,xlsx]', que pesa menos.

Al acabar: markitdown --help te muestra la ayuda.

4. Convierte la tarifa y las ventas

Copia los dos ficheros a la carpeta y ejecuta:

markitdown tarifa-distribuidor-2026.pdf -o tarifa.md
markitdown ventas-octubre.xlsx -o ventas.md

Abre los .md con cualquier editor de texto. En el Excel, cada hoja sale con su nombre como título y debajo su tabla.

Al acabar: dos ficheros de texto que se leen bien, con las tablas en filas y columnas.

5. Pásaselo a Claude

Adjunta tarifa.md y ventas.md en una conversación (o, si usas Claude Code, déjalos en la carpeta del proyecto) y pide algo concreto:

Soy el dueño de un bar de tapas en Bilbao. Te paso dos ficheros:
- tarifa.md: la tarifa 2026 de mi distribuidor de bebidas.
- ventas.md: lo que vendí en octubre, por referencia.

1. Haz una tabla con las 15 referencias que más vendo, su precio de compra
   según la tarifa y cuánto me dejan por unidad si las vendo al precio de carta
   que te pongo abajo.
2. Dime qué referencias vendo menos de 10 veces al mes y podría quitar.
3. Si algún dato no cuadra entre los dos ficheros, dímelo en vez de inventarlo.

Precios de carta: caña 2,20 €, txakoli copa 3,00 €, vermut 3,50 €.

Al acabar: tienes una tabla que puedes comprobar a mano con dos o tres filas.

6. Si convertís mucho: el servidor MCP

El repositorio incluye markitdown-mcp, un servidor MCP con una sola herramienta (convert_to_markdown) para que Claude convierta ficheros sin que tú pases por la terminal. Hoy está en versión alfa (0.0.1a8) y el README recomienda usarlo con Docker en Claude Desktop. Para un bar, con los pasos de arriba sobra. Si te pica la curiosidad, lee primero MCP explicado sin tecnicismos.

Errores típicos

• «No matching distribution found for markitdown» → estás con Python 3.9. Instala uno nuevo (paso 1) y crea el entorno con él.
• zsh: no matches found → faltan las comillas alrededor de markitdown[all].
• El PDF sale vacío o casi → es un PDF escaneado (una foto de papel). MarkItDown saca el texto que existe, no lee imágenes salvo que configures su plugin de OCR, que necesita conectar un modelo de IA con visión. Pídele al proveedor la tarifa en PDF «de verdad» o en Excel.
• Al día siguiente markitdown «no existe» → cerraste la terminal y el entorno se desactivó. Entra en la carpeta y vuelve a hacer source .venv/bin/activate (o .venv\Scripts\activate).
• Fiarse de la tabla a ciegas → la conversión de tablas complejas puede descolocar alguna columna. Comprueba siempre dos o tres precios contra el original.

Siguiente paso

Si quieres sacar el coste por plato con esos precios, sigue con Escandallo y food cost con Claude. Y si los ficheros tienen datos sensibles que no quieres mandar a ningún servicio, combínalo con IA en tu ordenador sin pagar (Ollama).