claude-office-skills/office-to-md

O que office-to-md faz?

Skill para converter documentos do Office (Word, Excel, PowerPoint) em Markdown.

Visão Geral

Esta skill provê uma interface padronizada para converter arquivos .docx, .xlsx e .pptx para marcação Markdown estruturada. É ideal para integrar conteúdo de escritório em fluxos de trabalho de IA, documentação e automação.

Plataformas Suportadas

• Claude Code
• Cursor
• Codex
• Outros agentes de IA com suporte a comandos shell e Python

Funcionalidades

• Conversão de Word (.docx): Preserva parágrafos, estilos de cabeçalho, listas (ordenadas e não ordenadas), negrito, itálico, links e tabelas simples.
• Conversão de Excel (.xlsx): Converte planilhas em tabelas Markdown com cabeçalhos e alinhamento básico. Cada planilha vira uma seção.
• Conversão de PowerPoint (.pptx): Extrai texto de slides, preservando hierarquia de títulos e marcadores.
• Saída limpa: Remove formatação complexa, mantendo apenas estrutura semântica.

Como Usar

Pré-requisitos

• Python 3.8 ou superior
• Bibliotecas Python:
  • python-docx
  • openpyxl
  • python-pptx

Instalação:

pip install python-docx openpyxl python-pptx

Comando de Conversão

python converter.py caminho/para/arquivo.docx --output saida.md
python converter.py caminho/para/planilha.xlsx --output saida.md
python converter.py caminho/para/apresentacao.pptx --output saida.md

Se --output não for especificado, o resultado será impresso no terminal (stdout).

Estrutura de Saída

• Word: Cabeçalhos #, ##, etc.; parágrafos; listas com - ou 1.; tabelas como Markdown.
• Excel: Por padrão, cada planilha inicia com ## Nome da Planilha; linhas viram linhas de tabela.
• PowerPoint: Cada slide vira um cabeçalho ## Slide N; texto de caixas de texto aparece como parágrafos ou listas.

Limitações

• Formatação avançada (como imagens incorporadas, gráficos, macros) não é convertida.
• Tabelas complexas (com mesclagem de células) podem não preservar completamente a estrutura.
• Animações e transições no PowerPoint são ignoradas.

Exemplo

Arquivo Word exemplo.docx:

Título: Relatório
Parágrafo: Este é um exemplo.
Lista:
- Item 1
- Item 2

Saída exemplo.md:

# Relatório

Este é um exemplo.

- Item 1
- Item 2

Notas Técnicas

• O script converter.py deve estar no diretório corrente ou no PATH.
• Para uso em agentes de IA, certifique-se de que o ambiente virtual ou Python esteja configurado.
• Variável de ambiente OFFICE_TO_MD_DIR pode apontar para o diretório do script (opcional).

Suporte

Relate problemas ou sugestões no repositório oficial: claude-office-skills/office-to-md.