convez.ai
SkillAutomaçãoIntermediário
Lucifer5397

MarkItDown Skill — Conversor Universal de Documentos

Lucifer5397/markitdown-skill

Converta qualquer documento para Markdown em um comando

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-skill

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

AgentSkill License: CC BY-NC 4.0 Non-Commercial GitHub stars

Multi-language: English | 简体中文 | Español | हिन्दी | العربية

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

CategoryFormats
DocumentsPDF, Word (.docx), PowerPoint (.pptx)
SpreadsheetsExcel (.xlsx, .xls)
WebHTML, YouTube URLs
DataCSV, JSON, XML
ImagesJPG, PNG, GIF, WebP, BMP, TIFF (OCR)
AudioMP3, WAV, FLAC, OGG, M4A (transcription)
ArchivesZIP (iterates all contents)
E-booksEPub
Email.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 AgentSupport
Claude CodeYes
OpenClawYes
Codex (OpenAI)Yes
Gemini CLIYes
CursorYes
VS Code CopilotYes

License

CC BY-NC 4.0 — free for personal, educational, and research use. Commercial use prohibited.

Ver o original no GitHub

Bom para

Relacionados