Conversor online gratuito de DOCX para ADOC

Documentos do Word são convertidos para AsciiDoc quando a documentação precisa ser mantida no Git, revisada como texto ou renderizada por um sistema de publicação AsciiDoc. O código-fonte .adoc resultante é mais fácil de comparar, mesclar e reutilizar em compilações HTML ou PDF do que um arquivo do Word.

Formato DOCX

.docx é o formato padrão do Microsoft Word e faz parte do Office Open XML. Um arquivo DOCX é um pacote ZIP que contém XML e arquivos relacionados a texto, estilos, tabelas, imagens, comentários, revisões, cabeçalhos, rodapés e propriedades do documento.

Microsoft Word é seu editor principal; LibreOffice Writer, Google Docs, Apple Pages e muitos sistemas de gerenciamento de documentos também podem abrir ou exportar DOCX. O formato preserva bem o layout e a formatação de documentos de escritório, mas sua estrutura empacotada não é adequada para revisão linha a linha no controle de versões.

Formato ADOC

.adoc normalmente identifica um arquivo-fonte AsciiDoc. AsciiDoc é texto simples UTF-8 com marcação para títulos de seção, listas, tabelas, links, blocos de código, admonitions, atributos e referências a imagens. Outras extensões comuns do AsciiDoc são .asciidoc e .ad.

Processadores como Asciidoctor podem renderizar AsciiDoc como HTML, PDF, DocBook, EPUB ou saída para sites de documentação. As imagens normalmente são arquivos separados referenciados pelo código-fonte, o que mantém o texto legível e facilita o gerenciamento dos recursos de imagem no Git.

Confirme o formato necessário antes de converter. Alguns produtos usam .adoc para arquivos proprietários não relacionados; esta conversão produz texto AsciiDoc, não esses formatos.

Converter o arquivo

Para converter sem instalar software, envie o arquivo DOCX para o conversor em 101convert.com, selecione ADOC como formato de saída, inicie a conversão e baixe o arquivo .adoc gerado. Abra-o em um editor de texto e verifique títulos, tabelas, links e referências a imagens antes de usá-lo em um fluxo de publicação.

Para uma conversão local repetível, Pandoc lê DOCX e grava AsciiDoc. Depois de instalar o Pandoc, execute este comando na pasta que contém o documento:

pandoc input.docx --from=docx --to=asciidoc --extract-media=media --wrap=none --output=output.adoc

--extract-media=media grava as imagens incorporadas em um diretório media e gera referências a imagens na saída. Mantenha esse diretório junto com o arquivo ADOC ao mover ou publicar o documento. --wrap=none evita a quebra arbitrária de linhas, o que pode produzir diferenças mais limpas no controle de código-fonte.

Renderize o resultado com Asciidoctor para verificar a marcação gerada:

asciidoctor output.adoc

Isso cria output.html, que pode ser aberto em um navegador para revisão.

Limitações da conversão

A conversão depende da semântica do documento, e não da aparência visual. Aplique os estilos de título integrados do Word antes da conversão; textos que foram apenas aumentados ou colocados em negrito sem um estilo de título podem permanecer como um parágrafo normal.

Parágrafos simples, estilos de título, listas, ênfase básica, links e tabelas simples geralmente são transferidos de forma satisfatória. Tabelas mescladas ou aninhadas, larguras de coluna fixas, sombreamento de células, caixas de texto, objetos flutuantes, SmartArt, equações, layout de página complexo e imagens posicionadas não têm equivalente direto no AsciiDoc e exigem reescrita manual ou substituição por imagens e marcação padrão.

Resolva as alterações controladas antes da conversão e preserve separadamente os comentários necessários. Cabeçalhos, rodapés, campos de número de página, macros, proteção de documentos e controles de layout específicos do Word não são conteúdos confiáveis do AsciiDoc; mova as informações essenciais para seções comuns do documento.

Hiperlinks externos geralmente são convertidos corretamente, mas os favoritos e as referências cruzadas do Word devem ser testados após a renderização. Para obter links internos duráveis, atribua âncoras AsciiDoc explícitas, como [[installation]], e faça referência a elas com <<installation,Installation>>.