MarkItDown Skill — Conversor Universal de Documentos
Lucifer5397/markitdown-skill
Converta qualquer documento para Markdown em um comando
Ver no GitHubSkill para Claude Code e IA agents que converte qualquer arquivo (PDF, Word, Excel, PPT, imagens com OCR, áudio, HTML, ZIP, YouTube) para Markdown limpo e estruturado. Powered by Microsoft MarkItDown, com suporte a múltiplos idiomas e integração nativa em editores como VS Code e Cursor.
Instalação
npx convez-ai Lucifer5397/markitdown-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Extrair texto de PDFs e documentos para processamento por IA
- Converter apresentações e planilhas em Markdown para versionamento
- Transcrever áudio e extrair texto de imagens (OCR) automaticamente
- Processar arquivos em lote para pipelines de RAG (Retrieval-Augmented Generation)
Veredito

Ferramenta robusta e pronta para produção baseada no MarkItDown do Microsoft. Cobre um espectro impressionante de formatos e integra perfeitamente com Claude Code e Cursor, ideal para automação de processamento de documentos em fluxos de IA. Limitação: licença CC BY-NC proíbe uso comercial direto.
README
A tradução para o português deste README ainda está na fila.
MarkItDown Converter — Claude Code Skill
A universal Agent Skill for Claude Code, OpenClaw, Codex, Cursor, and VS Code Copilot. Powered by Microsoft MarkItDown (131k+ Stars). One command to convert any file to Markdown.
Supported Formats
| Category | Formats |
|---|---|
| Documents | PDF, Word (.docx), PowerPoint (.pptx) |
| Spreadsheets | Excel (.xlsx, .xls) |
| Web | HTML, YouTube URLs |
| Data | CSV, JSON, XML |
| Images | JPG, PNG, GIF, WebP, BMP, TIFF (OCR) |
| Audio | MP3, WAV, FLAC, OGG, M4A (transcription) |
| Archives | ZIP (iterates all contents) |
| E-books | EPub |
| .eml |
Installation
1. Install the Skill
git clone https://github.com/Lucifer5397/markitdown-skill.git ~/.claude/skills/markitdown-converter/
2. Install the Python Package
pip install "markitdown[all]"
3. Optional: System Dependencies
# OCR support (image to text)
# Windows: winget install tesseract-ocr
# macOS: brew install tesseract
# Linux: sudo apt-get install tesseract-ocr
# Audio transcription
# Windows: winget install ffmpeg
# macOS: brew install ffmpeg
# Linux: sudo apt-get install ffmpeg
Usage
Once installed, simply say in Claude Code:
"Convert this PDF to Markdown"
"Extract text from this Word document"
"Convert all files in this folder to md"
"Extract text from this image"
The agent will auto-trigger markitdown-converter to handle the task.
Skill Structure
markitdown-skill/
├── SKILL.md # Main skill file (AgentSkill spec)
├── README.md # This file
├── LICENSE # MIT License
├── references/
│ ├── installation.md # Full installation guide
│ ├── formats.md # Format-by-format breakdown
│ ├── advanced.md # Azure, plugins, RAG pipelines
│ └── troubleshooting.md # Common issues and fixes
├── examples/
│ ├── basic_conversion.py # Basic conversion examples
│ ├── batch_convert.py # Parallel batch converter
│ └── pipeline_example.py # Full RAG pipeline
└── scripts/
└── batch_convert.py # Standalone batch tool
Compatibility
| AI Agent | Support |
|---|---|
| Claude Code | Yes |
| OpenClaw | Yes |
| Codex (OpenAI) | Yes |
| Gemini CLI | Yes |
| Cursor | Yes |
| VS Code Copilot | Yes |
License
CC BY-NC 4.0 — free for personal, educational, and research use. Commercial use prohibited.