Conversor online gratuito de ASCIIDOC para ORG

O que é o formato ASCIIDOC

AsciiDoc é um formato de marcação em texto simples para documentação técnica, manuais, arquivos README, livros e sites. Os arquivos normalmente usam as extensões .adoc ou .asciidoc e são criados com Asciidoctor, o processador AsciiDoc original, sistemas de documentação como Antora ou qualquer editor de texto.

AsciiDoc oferece suporte a títulos hierárquicos, atributos, referências cruzadas, tabelas, advertências, listagens de código-fonte, imagens, includes, condicionais e extensões de bloco. Sua sintaxe é mais expressiva do que a marcação leve básica, mas vários desses recursos não têm um equivalente direto no Org.

O que é o formato ORG

Org é um formato de marcação em texto simples associado ao modo Org do Emacs. Os arquivos Org usam a extensão .org e combinam títulos estruturados com estados TODO, tags, propriedades, tabelas, blocos de código-fonte, links, citações, agendamento e dados de agenda.

Org é útil quando o documento convertido será editado no Emacs, consultado com a agenda do Org ou ferramentas de pesquisa, exportado para HTML ou PDF ou mantido como parte de um projeto de programação letrada. Sua sintaxe de títulos usa asteriscos, os blocos de código-fonte usam #+BEGIN_SRC e #+END_SRC, e os links usam a notação de colchetes própria do Org.

Como converter ASCIIDOC para ORG na prática

O fluxo de trabalho para desktop mais confiável é usar Asciidoctor seguido de Pandoc. Asciidoctor resolve a sintaxe e os includes do AsciiDoc, enquanto Pandoc converte a estrutura DocBook resultante para Org.

1. Instale Asciidoctor e Pandoc usando os pacotes apropriados para o seu sistema operacional.
2. No diretório que contém o arquivo de origem, gere DocBook e encaminhe o resultado para o Pandoc:

asciidoctor -b docbook5 -o - input.adoc | pandoc -f docbook -t org -o output.org

O comando lê input.adoc, grava a saída DocBook do Asciidoctor na saída padrão e salva o resultado Org como output.org. Substitua os nomes dos arquivos conforme necessário; use o mesmo diretório de trabalho quando o documento contiver caminhos relativos para imagens ou includes.

Para um fluxo de trabalho em várias etapas, salve o arquivo intermediário para poder inspecioná-lo:

asciidoctor -b docbook5 -o intermediate.xml input.adoc
pandoc -f docbook -t org intermediate.xml -o output.org

Abra output.org no Emacs e verifique os níveis dos títulos, os links, os nomes das linguagens de código-fonte, as tabelas, os caminhos das imagens e quaisquer metadados do Org que devam ser adicionados manualmente. Para uma conversão sem instalação, use o conversor gratuito em 101convert.com e baixe o arquivo .org resultante.

Limitações de qualidade e compatibilidade

O conteúdo estrutural geralmente é convertido corretamente, mas atributos do AsciiDoc, seções condicionais, funções personalizadas, blocos passthrough, extensões de diagramas e macros específicas do processador podem ser omitidos ou reduzidos a texto comum. Asciidoctor expande os includes padrão durante o primeiro comando, mas os arquivos incluídos devem estar disponíveis e ser referenciados com caminhos relativos utilizáveis.

As advertências e os blocos estilizados do AsciiDoc podem não ser mapeados para construções nativas do Org; revise-os após a conversão. As tabelas podem exigir alinhamento ou reescrita manual, e as referências a imagens continuam dependendo dos arquivos de recursos originais. DocBook é uma representação intermediária, portanto, a estilização do AsciiDoc e o comportamento específico do backend não são preservados exatamente.

Se a origem usar extensões personalizadas do Asciidoctor, converta primeiro uma amostra representativa e compare o arquivo Org gerado com o original antes de processar um conjunto maior de documentos.