Inicio / Skills / Ofimática y documentos / Convertir Excel a Markdown
Ofimática y documentos

Convertir Excel a Markdown

awesome-copilot communityMITIdioma del Skill: Inglés
Licencia verificadaIncluye scriptsRiesgo medio
DemostraciónEjecución real · claude-sonnet-5-5 · octubre de 2026
I have a workbook at .claude/skills/convert-excel-to-md/sales.xlsx with our Q3 sales. Please tell me the total revenue for each product, which region has a missing value, and the refunded units per region. The Python interpreter that has markitdown installed is /private/tmp/claude-501/-Users-huipeizhu-git-aibars-portal/1db8d52d-0133-4843-9915-dc2b4b4fafd0/scratchpad/mdtest/.venv/bin/python — use it by that exact path, and use relative paths for the script and the workbook.
Skill: convert-excel-to-md
Read: sales/sales.md

Revenue totals (from the Revenue column of the Q3 Sales sheet):

  • Widget: 1,900 (North 1,140 + South 760)
  • Gadget: 1,800 (East 1,080 + North 720). West's Gadget row has no revenue value, so it isn't included.

Missing value: West. The 2026-07-05 Gadget row has no Units and no Revenue. The unit price is 24.0, so the revenue can't be worked out without the units.

The sheet's own Total row shows 3,700 revenue and 275 units. That matches the sum of the rows that have values (1,900 + 1,800 = 3,700), so the total also leaves out West's missing sale.

Refunded units per region (Refunds sheet):

  • East: 3
  • North: 2
  • South and West: none listed, so presumably 0.

I converted the workbook to Markdown, and the output is in .claude/skills/convert-excel-to-md/sales/sales.md.

How it was tried: the Skill's Python script needs the markitdown package, so I installed it in an isolated temporary environment and gave the interpreter path in the prompt. Bash was allowed only for that one script command. The sample workbook was built by me (it contains one deliberately empty cell and a refund table). The model's numbers matched what I recomputed in code: Widget 1,900, Gadget 1,800, total 3,700.

Qué hace

Ejecuta un script de Python incluido, basado en MarkItDown, que convierte un libro de trabajo .xlsx en tablas Markdown para que un modelo pueda analizar, resumir o extraer datos de él de forma fiable. Las imágenes incrustadas se extraen del libro de trabajo y se escriben en una carpeta img/, y la sección de cada hoja enlaza a sus imágenes. Funciona con un único archivo o con una carpeta de libros de trabajo, opcionalmente de forma recursiva, y la salida va a una carpeta <name>/ junto al origen o a una carpeta que elijas con -o.

Cómo funciona

  1. Configuración inicial única desde references/setup.md (Python, pip y markitdown[xlsx]).
  2. python scripts/convert_excel_to_md.py <file-or-folder> [-o <output-folder>] [--recursive].
  3. El modelo lee el <name>.md resultante.

Ideal para

Hacer preguntas sobre una hoja de cálculo, extraer datos de ella o resumirla.

Notas y riesgos

Riesgo medio: ejecuta un script de Python y requiere `pip install` de `markitdown[xlsx]`; el paso para Linux del archivo de configuración usa `sudo apt-get install` (permisos de administrador). Escribe `<name>/<name>.md` y una carpeta `img/`, y elimina una carpeta `img/` existente en el destino antes de extraer las imágenes (solo esa subcarpeta; confirmado en las pruebas, así que elige una carpeta de salida que puedas permitirte modificar). La descripción de la Skill indica al modelo que ejecute el script para cada `.xlsx` y que también invoque las Skills hermanas de PDF y Word, que no se enumeran aquí. No realiza solicitudes de red. Se probó en un entorno aislado (archivo único, lote, `-o`, `.xls` y rutas no válidas rechazadas), con salida correcta, pero: las celdas vacías aparecen como `NaN`, un `|` en una celda rompe la tabla, las celdas con fórmulas en archivos que nunca se guardaron con Excel muestran NaN y un `.xlsx` corrupto se informa como OK.

SKILL.md original5 archivos en este paquete