MarkItDown: converta o arquivo antes de mandar pro Claude
O MarkItDown é uma ferramenta gratuita e de código aberto da Microsoft que transforma PDF, Word, Excel, PowerPoint e até link do YouTube em Markdown, um texto puro. Você manda o arquivo convertido pro Claude no lugar do original.
Pra quem manda muito documento pro Claude e vê a sessão acabar cedo. Precisa de um computador com Python instalado (versão 3.10 ou mais nova) e de abrir o terminal uma vez.
Passo a passo
Confira se tem Python
Abra o Terminal (no Mac) ou o PowerShell (no Windows) e cole o primeiro comando abaixo. Se aparecer um número de versão a partir de 3.10, siga. Se não, instale o Python pelo site oficial python.org.
Instale o MarkItDown
Cole o comando de instalação. Ele baixa a ferramenta com todos os formatos de arquivo de uma vez.
Converta o arquivo
Cole o comando de conversão trocando o nome do arquivo de entrada e o do arquivo de saída. O resultado é um arquivo terminado em .md, que abre em qualquer editor de texto.
Mande o .md pro Claude
Anexe o arquivo convertido na conversa no lugar do PDF ou do Word original.
Ou peça pro Claude Code fazer
Se você usa o Claude Code, cole o último prompt abaixo e ele instala e converte a pasta inteira por você.
Prompts para copiar
Conferir a versão do Python
python3 --version
Instalar o MarkItDown
pip install 'markitdown[all]'
Converter um arquivo
markitdown [CAMINHO-DO-ARQUIVO.pdf] -o [NOME-DE-SAIDA.md]
Pedir pro Claude Code converter uma pasta inteira
Você vai preparar documentos para eu usar em conversas com o Claude gastando menos. Pasta com os arquivos originais: [CAMINHO DA PASTA] Tipos de arquivo que tem lá: [EX.: PDF, DOCX, XLSX, PPTX] Tarefa: confira se o MarkItDown da Microsoft está instalado (comando markitdown). Se não estiver, instale com pip install 'markitdown[all]'. Depois converta cada arquivo da pasta para Markdown e salve numa subpasta chamada convertidos, mantendo o mesmo nome com final .md. No fim, me mostre uma tabela com o nome de cada arquivo, o tamanho do original e o tamanho do convertido, e avise quais saíram com tabela quebrada ou texto faltando. Não apague nem altere os arquivos originais. Não resuma o conteúdo: a conversão tem que manter o texto inteiro.
Links
- MarkItDownRepositório oficial da Microsoft no GitHub, com a lista de formatos aceitos e os comandos.
PDF escaneado (foto de página) não tem texto para extrair. Nesse caso a conversão sai vazia ou incompleta, e o arquivo precisa passar por leitura de imagem antes.
Quanto você economiza depende do arquivo. Não existe número oficial de tokens poupados por PDF, então compare na sua própria conta.
Conferido em 14/11/2026. Ferramenta muda rápido: se algo não bater, me avisa no direct.