Instalación y uso de MarkItDown

Juan Pedro Sánchez Coca

1. Instalación

Para instalar markitdown con todos los conversores (PDF, Word, PowerPoint, Excel…):

pip install "markitdown[all]"

Sintaxis

  • pip install → instala un paquete de Python.
  • "markitdown[all]" → nombre del paquete; [all] añade las dependencias opcionales para todos los formatos. En Windows se usan comillas dobles para que los corchetes no den problemas.

Si no se reconoce el comando pip

py -m pip install "markitdown[all]"

Sintaxis

  • py → lanzador de Python para Windows.
  • -m pip → ejecuta el módulo pip con ese intérprete (útil cuando pip no está en el PATH).

Si se usa Python portable

Hay que indicar la ruta completa del intérprete:

& d:\SW\Programacion\Python\python-3.12.4.amd64\python.exe -m pip install "markitdown[all]"

Sintaxis

  • & → operador de llamada de PowerShell; ejecuta el programa indicado por una ruta.
  • d:\...\python.exe → ruta al intérprete de Python portable.
  • -m pip install "markitdown[all]" → igual que antes, pero usando ese Python concreto.

2. Conversión de un documento

Con Python portable

& d:\SW\Programacion\Python\python-3.12.4.amd64\python.exe -m markitdown "C:\Users\granasat\Downloads\Consentimiento.pdf" -o "C:\Users\granasat\Downloads\Consentimiento.md"

Sintaxis

  • -m markitdown → ejecuta markitdown como módulo de ese Python.
  • "...\Consentimiento.pdf" → documento de entrada (ruta completa entre comillas).
  • -o "...\Consentimiento.md" → -o (output) indica el archivo de salida en Markdown.
Nota: si la terminal ya está en la carpeta del documento, basta con el nombre del archivo:

& d:\SW\Programacion\Python\python-3.12.4.amd64\python.exe -m markitdown Consentimiento.pdf -o Consentimiento.md

Con Python instalado normalmente

No hace falta indicar la ruta del intérprete:

markitdown documento.pdf -o documento.md

Sintaxis

  • markitdown → programa de conversión.
  • documento.pdf → archivo de entrada.
  • -o documento.md → archivo de salida.

Si markitdown no se reconoce (su carpeta Scripts no está en el PATH), se puede lanzar como módulo:

python -m markitdown documento.pdf -o documento.md

3. Consejos

  • Pulsa Tab al escribir el nombre de un archivo para autocompletarlo y evitar erratas.
  • Si el .md sale vacío, probablemente el PDF es escaneado (solo imagen) y necesita OCR.
  • Formatos soportados: PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, imágenes, audio, etc.