Conversor online gratuito de AD para MD

Markdown é comumente necessário para arquivos README, repositórios Git, sites de documentação e edição simples, enquanto alguns documentos de origem chegam como arquivos AsciiDoc com a extensão mais curta .ad. A conversão preserva seu conteúdo legível enquanto adapta títulos, listas, links, blocos de código e tabelas à sintaxe Markdown.

O que é o formato AD

Na categoria de arquivos de texto, .ad geralmente identifica um arquivo de origem AsciiDoc. AsciiDoc é uma linguagem de marcação de texto simples para documentação técnica, livros, manuais, arquivos README e páginas da Web; a mesma linguagem é armazenada com mais frequência como .adoc ou .asciidoc.

Arquivos AsciiDoc podem ser criados com o processador AsciiDoc original, Asciidoctor, editores de texto e sistemas de compilação de documentação. Eles contêm marcação de origem legível, como títulos de seção, listas, links, blocos de código-fonte, advertências, tabelas, atributos e diretivas include. A extensão, por si só, não é definitiva; portanto, confirme se o arquivo contém sintaxe AsciiDoc antes de convertê-lo.

O que é o formato MD

.md identifica um arquivo Markdown. Markdown usa caracteres de texto simples para títulos, ênfase, links, listas, citações, blocos de código e outras estruturas de documentos. GitHub, GitLab, geradores de sites estáticos, aplicativos de anotações, plataformas de documentação e editores de código geralmente renderizam Markdown.

Markdown é útil quando um documento precisa continuar fácil de ler sem um renderizador, funcionar bem com controle de versão ou ser aceito como README ou fonte de documentação. GitHub Flavored Markdown, comumente chamado de GFM, adiciona tabelas, listas de tarefas, texto tachado e blocos de código delimitados.

Como converter AD em MD de fato

Usando Asciidoctor e Pandoc

Para uma conversão confiável, use Asciidoctor para interpretar a fonte AsciiDoc e gerar DocBook XML; em seguida, use Pandoc para converter esse arquivo intermediário estruturado em Markdown GFM. Instale Asciidoctor e Pandoc, coloque a fonte no diretório de trabalho e execute:

1. Converta o arquivo AsciiDoc em DocBook XML:
   asciidoctor -b docbook5 -o input.xml input.ad
2. Converta o XML em Markdown:
   pandoc -f docbook -t gfm input.xml -o output.md
3. Abra output.md em um editor Markdown e verifique títulos, links, tabelas, imagens, listas e blocos de código.

Para um pipeline de shell de uma única etapa, use:

asciidoctor -b docbook5 -o - input.ad | pandoc -f docbook -t gfm -o output.md

Usando o conversor online integrado

Você pode converter o arquivo gratuitamente em 101convert.com sem instalar software: selecione o formato de entrada AD, carregue input.ad, escolha MD como formato de saída, inicie a conversão e baixe o arquivo .md resultante.

Limitações de qualidade e compatibilidade

A conversão altera a marcação em vez de simplesmente renomear a extensão. Atributos AsciiDoc, conteúdo condicional, macros, referências cruzadas, diagramas incorporados e estruturas complexas de tabelas ou advertências podem exigir edição manual após a conversão.

Use caminhos que continuem válidos a partir do local do arquivo Markdown. As referências de imagens podem precisar de correção, e funções ou atributos específicos do AsciiDoc podem ser descartados porque o Markdown padrão não tem equivalente. A saída GFM geralmente é o destino mais compatível para GitHub e GitLab, enquanto o Markdown básico é preferível quando o destino aceita apenas a sintaxe original.

Diretivas include do AsciiDoc e substituições de origem podem afetar o resultado gerado. Revise a saída após o pré-processamento, especialmente quando a fonte usa arquivos externos, atributos personalizados ou caminhos relativos de imagens.