CommunityEscrita e Ediçãogithub.com

steipete/markdown-converter

Conversão de Markdown: PDF, Office, HTML, dados, OCR, áudio, ZIP, YouTube.

O que é markdown-converter?

Este skill utiliza a ferramenta `uvx markitdown` para converter diversos formatos de arquivo para Markdown, sem necessidade de instalação prévia. Ele é útil para desenvolvedores e usuários de agentes de IA que precisam extrair e processar conteúdo de documentos, planilhas, apresentações, mídia e outros formatos comuns. Suporta uma ampla gama de fontes, incluindo PDF, Word, Excel, PowerPoint, HTML, CSV, JSON, XML, imagens (com OCR), áudio (com transcrição), arquivos ZIP, URLs do YouTube e EPub. O skill funciona sob demanda, executando um comando via `uvx`, e oferece opções avançadas como uso de inteligência artificial da Azure para melhorar a extração de PDFs complexos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/markdown-converter

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Conversor Markdown

Converta arquivos para Markdown usando uvx markitdown — sem necessidade de instalação.

Uso básico

# Converter para saída padrão
uvx markitdown input.pdf

# Salvar em arquivo
uvx markitdown input.pdf -o output.md
uvx markitdown input.docx > output.md

# A partir da entrada padrão
cat input.pdf | uvx markitdown

Formatos suportados

  • Documentos: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
  • Web/Dados: HTML, CSV, JSON, XML
  • Mídia: Imagens (EXIF + OCR), Áudio (EXIF + transcrição)
  • Outros: ZIP (percorre conteúdos), URLs do YouTube, EPub

Opções

-o SAIDA        # Arquivo de saída
-x EXTENSAO     # Sugerir extensão de arquivo (para entrada padrão)
-m TIPO_MIME    # Sugerir tipo MIME
-c CHARSET      # Sugerir charset (ex.: UTF-8)
-d              # Usar Azure Document Intelligence
-e ENDPOINT     # Endpoint do Document Intelligence
--use-plugins   # Habilitar plugins de terceiros
--list-plugins  # Mostrar plugins instalados

Exemplos

# Converter documento Word
uvx markitdown report.docx -o report.md

# Converter planilha Excel
uvx markitdown data.xlsx > data.md

# Converter apresentação PowerPoint
uvx markitdown slides.pptx -o slides.md

# Converter com sugestão de tipo de arquivo (para entrada padrão)
cat documento | uvx markitdown -x .pdf > output.md

# Usar Azure Document Intelligence para melhor extração de PDF
uvx markitdown scan.pdf -d -e "https://seu-recurso.cognitiveservices.azure.com/"

Notas

  • A saída preserva a estrutura do documento: cabeçalhos, tabelas, listas, links
  • A primeira execução armazena as dependências em cache; execuções subsequentes são mais rápidas
  • Para PDFs complexos com extração deficiente, use -d com Azure Document Intelligence

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

Habilidades Relacionadas