# Markdown Converter

> Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.

Source: https://skillsagentes.com/skills/intellectronica/agent-skills/markdown-converter
Repository: https://github.com/intellectronica/agent-skills
Author: intellectronica
License: CC0-1.0
Updated: hace 6 meses
Context cost: 76 tok installed, 492 tok once triggered, 492 tok with every bundled file
Bundle: 1 file, 2 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent claude-code
```

## What it does

- Convierte archivos (PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, imágenes, audio, ZIP, YouTube, EPub) a Markdown usando `uvx markitdown`
- Preserva la estructura del documento: encabezados, tablas, listas y enlaces
- Permite usar Azure Document Intelligence para mejorar la extracción de PDFs complejos con `-d`

## Use it when

- Convertir PDF, Word (.docx), PowerPoint (.pptx) o Excel (.xlsx, .xls) a Markdown
- Convertir HTML, CSV, JSON o XML a Markdown
- Convertir imágenes (con EXIF/OCR), audio (con transcripción), ZIP, URLs de YouTube o EPubs a Markdown para procesamiento LLM o análisis de texto

## What triggers it

- "Convierte este PDF a Markdown"
- "Pasa este archivo .docx a formato Markdown"
- "Convierte esta hoja de Excel a Markdown"
- "Extrae el texto de este PDF escaneado usando Azure Document Intelligence"
- "Convierte este video de YouTube a Markdown"

## Before you install

- Requiere `uvx` (no necesita instalación previa de markitdown); para PDFs complejos se puede usar un endpoint de Azure Document Intelligence.

## Files

- SKILL.md — 2 KB

## SKILL.md

Reproduced verbatim from intellectronica/agent-skills under CC0-1.0. This section is the upstream document and is in English.

# Markdown Converter

Convert files to Markdown using `uvx markitdown` — no installation required.

## Basic Usage

```bash
# Convert to stdout
uvx markitdown input.pdf

# Save to file
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# From stdin
cat input.pdf | uvx markitdown
```

## Supported Formats

- **Documents**: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
- **Web/Data**: HTML, CSV, JSON, XML
- **Media**: Images (EXIF + OCR), Audio (EXIF + transcription)
- **Other**: ZIP (iterates contents), YouTube URLs, EPub

## Options

```bash
-o OUTPUT      # Output file
-x EXTENSION   # Hint file extension (for stdin)
-m MIME_TYPE   # Hint MIME type
-c CHARSET     # Hint charset (e.g., UTF-8)
-d             # Use Azure Document Intelligence
-e ENDPOINT    # Document Intelligence endpoint
--use-plugins  # Enable 3rd-party plugins
--list-plugins # Show installed plugins
```

## Examples

```bash
# Convert Word document
uvx markitdown report.docx -o report.md

# Convert Excel spreadsheet
uvx markitdown data.xlsx > data.md

# Convert PowerPoint presentation
uvx markitdown slides.pptx -o slides.md

# Convert with file type hint (for stdin)
cat document | uvx markitdown -x .pdf > output.md

# Use Azure Document Intelligence for better PDF extraction
uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/"
```

## Notes

- Output preserves document structure: headings, tables, lists, links
- First run caches dependencies; subsequent runs are faster
- For complex PDFs with poor extraction, use `-d` with Azure Document Intelligence

---

Skills Agentes — https://skillsagentes.com/skills/intellectronica/agent-skills/markdown-converter