# Markdown Converter

> Convierte documentos y archivos a Markdown usando markitdown: PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, imágenes, audio, ZIP, URLs de YouTube o EPubs, para procesamiento con LLM o análisis de texto.

Fuente: https://skillsagentes.com/skills/intellectronica/agent-skills/markdown-converter
Markdown: https://skillsagentes.com/skills/intellectronica/agent-skills/markdown-converter.md

Repositorio: https://github.com/intellectronica/agent-skills
Autor: intellectronica
Licencia: CC0-1.0
Actualizado: hace 8 meses
Coste de contexto: 76 tok instalada, 492 tok al activarse, 492 tok con todos los archivos del bundle
Bundle: 1 archivo, 2 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent claude-code
# Cursor
npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent cursor
# Codex
npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent codex
# Gemini CLI
npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent gemini
# Windsurf
npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent windsurf
# Cline
npx -y skills add intellectronica/agent-skills --skill markdown-converter --agent cline
```

## Qué hace

- 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`

## Cuándo usarla

- 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

## Qué la activa

- "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"

## Antes de instalar

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

## Archivos

- SKILL.md — 2 KB

## SKILL.md

Reproducido tal cual desde intellectronica/agent-skills bajo CC0-1.0. Esta sección es el documento original y está en inglés.

# 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

## Dónde encaja

- Categoría: [Documentos](https://skillsagentes.com/categorias/documentos.md) — Lee, escribe y transforma archivos PDF, DOCX, XLSX y PPTX.
- Creador: [intellectronica](https://skillsagentes.com/creators/intellectronica.md) — 22 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Skills relacionadas

- [Gpt Image 2](https://skillsagentes.com/skills/conardli/garden-skills/gpt-image-2.md): Generación y edición de imágenes con GPT Image 2, en 3 modos: Garden local (genera y guarda), Host-Native (prepara el prompt para la herramienta del anfitrión) o Advisor (solo entrega el prompt). 80+ plantillas en 18 categorías.
- [Raindrop Api](https://skillsagentes.com/skills/intellectronica/agent-skills/raindrop-api.md): Instrucciones completas para usar la API REST de Raindrop.io con curl y jq: autenticación, CRUD de colecciones, raindrops, tags, highlights, filtros, import/export y backups.
- [Ultrathink](https://skillsagentes.com/skills/intellectronica/agent-skills/ultrathink.md): Muestra arte ANSI colorido con la palabra "ultrathink". Se usa cuando el usuario escribe "ultrathink" o invoca /ultrathink.
- [Gog Cli](https://skillsagentes.com/skills/intellectronica/agent-skills/gog-cli.md): Úsalo cuando el usuario quiera operar Google Workspace desde la línea de comandos con gog/gogcli: Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Apps Script, Chat, Classroom, Contacts, Tasks, Groups, Admin, Keep y auth.
- [Copilot Sdk](https://skillsagentes.com/skills/intellectronica/agent-skills/copilot-sdk.md): Ayuda con el trabajo del GitHub Copilot SDK en Node.js/TypeScript, Python, Go, .NET y Java: setup, autenticación, permisos, streaming, tools personalizadas, custom agents, servidores MCP, hooks, skills y persistencia de sesiones.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)