Gasta menos tokens en Claude con MarkItDown

Lo más fácil: que tu IA te guíe

Guarda esta guía con el botón Guardar PDF de arriba (o copia el enlace de esta página), ábrela en Claude Code, Cowork o Codex y pega este prompt. Ellos ejecutan los pasos por ti; un chat normal (Claude o ChatGPT) también sirve, solo te va diciendo qué hacer.

Te adjunto la guía "Gasta menos tokens en Claude con MarkItDown". Soy principiante y nunca usé la Terminal. Acompáñame un paso a la vez: explícame en una frase qué hace cada cosa antes de hacerla, pídeme permiso antes de instalar algo y espera a que te confirme cuando un paso dependa de mí (abrir Claude Desktop, guardar archivos, reiniciar la app). Nunca me pidas claves por el chat. Si algo falla, arréglalo antes de seguir. Empieza preguntándome qué computadora tengo.

Qué necesitas

• Claude Desktop, la app de escritorio (plan gratis o Pro). La conexión no funciona en claude.ai desde el navegador; para eso está el último paso.
• MarkItDown: gratis y de código abierto, hecho por Microsoft.
• Tiempo: unos 10 minutos, una sola vez.

Abrir la Terminal en Mac: Cmd + Espacio, escribe Terminal y Enter. Ahí pegas los comandos con Cmd + V y Enter.

Paso 01Instala uv

Entra a: github.com/astral-sh/uv

Es un instalador que se encarga de descargar MarkItDown con la versión correcta de Python, sin que tengas que configurar nada. Copia esta línea y pégala en la Terminal:

curl -LsSf https://astral.sh/uv/install.sh | sh

Cierra la Terminal y ábrela de nuevo. Luego pega esto y copia la ruta que aparece (algo como /Users/tu-nombre/.local/bin/uvx). La usas en el paso 2.

which uvx

Paso 02Conecta MarkItDown a Claude Desktop

Entra a: github.com/microsoft/markitdown (es el repositorio oficial; el conector está en la carpeta packages/markitdown-mcp)

1. Abre Claude Desktop y entra a Settings → Developer → Edit Config. Se abre la carpeta con el archivo claude_desktop_config.json; ábrelo con TextEdit.
2. Pega este bloque y cambia la ruta de "command" por la que copiaste en el paso 1:

{
  "mcpServers": {
    "markitdown": {
      "command": "/Users/tu-nombre/.local/bin/uvx",
      "args": ["markitdown-mcp"]
    }
  }
}

1. Si el archivo ya tenía otros conectores, no borres nada: agrega solo el bloque "markitdown" dentro de "mcpServers".
2. Guarda, cierra Claude Desktop por completo con Cmd + Q y ábrelo de nuevo. En Settings → Developer debe aparecer markitdown.

Paso 03Úsalo sin subir el archivo

Si arrastras el PDF al chat, Claude lo lee completo y gastas los tokens igual. El truco es darle la ruta del archivo para que MarkItDown lo convierta primero.

1. En Finder, selecciona el archivo y presiona Option + Cmd + C. Eso copia su ruta.
2. Pega este prompt en Claude Desktop con la ruta y tu pregunta:

Convierte a Markdown con markitdown el archivo [pega aquí la ruta] y trabaja solo con ese texto. Después respóndeme esto: [tu pregunta]

Sirve para PDF, Word, Excel (con todas sus hojas), PowerPoint y también enlaces de YouTube, de los que saca la transcripción.

Para un contrato o propuesta:

Convierte a Markdown con markitdown el archivo [ruta]. Resúmelo en 10 líneas, lista los plazos, montos y obligaciones de cada parte, y marca cualquier cláusula que me convenga revisar con un abogado.

Para un video de YouTube:

Convierte a Markdown con markitdown este video: [enlace de YouTube]. Dame las 5 ideas principales y cómo aplicaría cada una en mi negocio de [tu negocio].

Sin conectar nada: convierte un archivo suelto

Sirve también si usas Claude en el navegador. En la Terminal escribe esto, deja un espacio, arrastra el archivo a la ventana de la Terminal y presiona Enter:

uvx --from 'markitdown[all]' markitdown -o ~/Desktop/documento.md

En tu Escritorio aparece documento.md. Súbelo al chat de Claude en lugar del PDF original.