Como Exportar Alterações Controladas do Word para Markdown com Tags de Autor

Exportar um documento do Word que contém alterações controladas para Markdown preservando os nomes dos autores é uma tarefa comum para escritores e desenvolvedores que colaboram no Word, mas finalizam o conteúdo em sistemas baseados em Markdown como GitHub ou geradores de sites estáticos. Por padrão, o Word não inclui uma exportação nativa para Markdown que carregue informações de revisão do autor. Este artigo explica como usar uma combinação de recursos nativos do Word, um complemento gratuito de terceiros e uma etapa manual de pós-processamento para manter as tags de autor na saída final em Markdown.

Visão geral do processo de exportação e ferramentas necessárias

O recurso Controlar Alterações do Word armazena cada revisão com o nome do autor, data e hora. Ao exportar para Markdown simples, esses metadados são perdidos, a menos que você use uma ferramenta que leia explicitamente os dados de revisão da estrutura XML do .docx. O arquivo .docx é um arquivo ZIP contendo arquivos XML. Dentro desse arquivo, o arquivo word/document.xml armazena as alterações controladas como elementos <w:ins> e <w:del> com atributos de autor e data.

Para exportar esses dados, você tem três opções principais. A primeira usa o complemento Writage, que fornece um botão na faixa de opções do Word para converter o documento em Markdown e pode incorporar alterações controladas como comentários Markdown. A segunda usa o Pandoc, um conversor gratuito de linha de comando, com um filtro Lua personalizado que lê o autor da revisão e o insere na saída. A terceira é um método manual que envolve salvar como HTML e depois extrair os dados de revisão com um script. Este artigo foca nos dois primeiros métodos, pois exigem menos esforço técnico.

Pré-requisitos:

• Word 2016 ou posterior (Windows ou Mac)
• Um documento com alterações controladas habilitadas e pelo menos uma revisão de um autor conhecido
• Para o Método 1: Complemento Writage (teste gratuito de 30 dias; licença paga após o teste)
• Para o Método 2: Pandoc instalado (gratuito) e um script Lua

Método 1: Usando o complemento Writage Markdown

Writage é um complemento do Word que adiciona uma guia Markdown na faixa de opções. Ele pode exportar alterações controladas como comentários Markdown com o nome do autor. Este método é o mais simples para usuários que preferem uma interface gráfica.

1. Instale o complemento Writage
   Baixe o instalador do site do Writage. Execute o instalador e siga as instruções. Após a instalação, reinicie o Word. Uma nova guia Markdown aparece na faixa de opções.
2. Abra o documento com alterações controladas
   No Word, abra o arquivo .docx que contém as alterações controladas que deseja exportar. Certifique-se de que todas as alterações estejam visíveis. Na guia Revisão, defina Exibir para Revisão como Todas as Marcas.
3. Configure as opções de exportação Markdown
   Vá para a guia Markdown. Clique em Opções. Na caixa de diálogo, procure a seção Controlar Alterações. Defina Exportar alterações controladas como comentários Markdown como Sim. Opcionalmente, ative Incluir nome do autor no comentário.
4. Exporte para Markdown
   Na guia Markdown, clique em Converter. Escolha Markdown (.md) como formato de saída. Selecione uma pasta de destino e clique em Salvar. O Writage cria um arquivo .md.
5. Verifique as tags de autor
   Abra o arquivo .md em um editor de texto. As inserções são mostradas como <!-- Author: NomeDoAutor --> antes do texto inserido. As exclusões são mostradas como <!-- Deleted by NomeDoAutor: --> seguidas do texto excluído em tachado. Se o nome do autor estiver ausente, verifique novamente a configuração em Opções.

Método 2: Usando Pandoc com um filtro Lua personalizado

Pandoc é uma ferramenta de linha de comando que pode converter entre muitos formatos de documento. Com um filtro Lua, você pode extrair o autor e a data da revisão do XML do .docx e inseri-los na saída Markdown. Este método oferece controle total sobre o formato de saída.

1. Instale o Pandoc
   Baixe o instalador de pandoc.org. Execute o instalador. Após a instalação, abra um prompt de comando (Windows) ou terminal (Mac). Digite pandoc --version para verificar se está instalado.
2. Crie o arquivo de filtro Lua
   Abra um editor de texto e cole o seguinte script Lua. Salve-o como track-changes-author.lua em uma pasta de fácil acesso, como sua pasta Documentos.
   -- track-changes-author.lua
function Pandoc(doc)
local meta = doc.meta
local blocks = doc.blocks
for i, block in ipairs(blocks) do
if block.t == "Para" then
local inlines = block.content
for j, inline in ipairs(inlines) do
if inline.t == "RawInline" and inline.format == "html" then
-- Verifica comentários de alteração controlada
if inline.text:match("