Depois de mais de um ano usando ferramentas de IA como Claude Code e Codex para acelerar a programação, desenvolvedores enfrentam uma contradição: enquanto o código ganha velocidade, a documentação continua sendo escrita manualmente no Microsoft Word. Um experimento recente explorou como automatizar esse processo — e revelou os limites dos formatos tradicionais.

O problema do Word na era da IA

Em maio de 2025, o consenso entre desenvolvedores que trabalham com IA é claro: arquivos Markdown (.md) são o melhor formato para comunicação com modelos de linguagem. O motivo é estrutural. Um arquivo .docx do Word é, na prática, um arquivo compactado (.zip) que contém XMLs como document.xml e styles.xml. Essa arquitetura torna a leitura e escrita direta por IA impraticável.

A solução mais comum — usar o conversor Pandoc para transformar Word em Markdown — funciona, mas com uma ressalva importante: estilos detalhados de formatação são perdidos no processo. Para documentação técnica que depende de hierarquia visual, tabelas complexas ou anotações específicas, essa perda pode ser significativa.

Fluxo proposto: Markdown como rascunho, Word como produto final

O método testado sugere um pipeline híbrido:

• Abrir o projeto no editor: usar VS Code ou similar para que a IA tenha acesso ao código-fonte e contexto do projeto.
• Iniciar a ferramenta de IA: ativar Codex, Claude ou equivalente dentro do ambiente de desenvolvimento.
• Passar atualizações em formato texto: enviar mudanças via arquivos Markdown ou texto puro. Quando há elementos visuais, incluir capturas de tela.
• Gerar rascunho automaticamente: a IA produz a documentação em Markdown, que depois pode ser convertida ou refinada manualmente no Word.

O que isso significa para equipes de desenvolvimento

A experiência expõe uma lacuna real: não há, até o momento, uma ferramenta de IA que leia e escreva nativamente em Word mantendo formatação complexa. Isso força equipes a escolher entre dois caminhos:

1. Adotar Markdown como padrão de documentação — ganhando velocidade e integração com IA, mas exigindo mudança cultural e possivelmente ferramentas de conversão para stakeholders não-técnicos.

2. Manter Word e aceitar o trabalho manual — preservando controle sobre estilo e compatibilidade corporativa, mas perdendo a automação que já existe no código.

A tendência, porém, aponta para o primeiro caminho. Plataformas como Notion, GitBook e Confluence já oferecem suporte nativo a Markdown e começam a integrar IA para sugestões e geração automática. A resistência do Word pode estar com os dias contados — não por superioridade técnica do Markdown, mas por fricção: quanto mais etapas manuais um processo exige, menos competitivo ele se torna.

Para quem quer experimentar, o fluxo é simples: abra seu projeto no VS Code, ative uma extensão de IA (como Continue, Codeium ou GitHub Copilot), e peça para gerar documentação a partir do código. Passe contexto adicional via arquivos .md ou prompts diretos. O resultado não será perfeito, mas será um rascunho — e rascunhos são exatamente o que IA faz melhor.

O que ainda falta: uma camada de IA que entenda semântica de formatação (negrito, itálico, hierarquia de títulos) e a preserve entre formatos. Até lá, a escolha é pragmática: velocidade ou controle. Raramente, ambos.