1001Ferramentas
🔤 Conversores

Conversor Markdown → AsciiDoc

Conversor básico de Markdown para AsciiDoc: títulos (== ===), listas, código inline, blocos --- e ênfase _italic_ *bold*.

AsciiDoc:

Markdown para AsciiDoc

AsciiDoc ocupa um lugar entre o Markdown e o DocBook: mantém a leitura confortável em texto puro, mas traz recursos que o Markdown não tem de fábrica — inclusão de arquivos, atributos, referência cruzada, admoestações. É o formato padrão da documentação da Red Hat, do Spring e de boa parte do ecossistema Java, o que faz a conversão aparecer bastante em migração de projeto.

Cole o Markdown e receba o AsciiDoc. Os cabeçalhos trocam a cerquilha pelo sinal de igual, com a mesma contagem de níveis; a lista com hífen vira lista com asterisco; negrito passa de asterisco duplo para asterisco simples e itálico de asterisco simples para sublinhado, que é a inversão que mais confunde quem transita entre os dois; o link inverte a ordem, com o endereço vindo antes do texto entre colchetes; e o bloco de código cercado vira o delimitador de quatro hifens.

A conversão é linha a linha, então cobre bem o corpo de um README e deixa de fora o que depende de estrutura: tabela, nota de rodapé e bloco aninhado. Vale conferir o resultado quando o texto original tiver asterisco solto no meio de uma frase — a troca de ênfase é feita por expressão regular, e um asterisco literal pode ser confundido com marcação.

Perguntas frequentes

Por que negrito e itálico trocam de símbolo?
Porque as duas linguagens escolheram convenções opostas. No Markdown, um asterisco é itálico e dois são negrito. No AsciiDoc, um asterisco é negrito e o sublinhado é itálico. É a diferença que produz documento inteiro em negrito quando alguém cola Markdown num arquivo .adoc sem converter.
AsciiDoc vale a pena sobre Markdown?
Depende do tamanho. Para README e página de projeto, o Markdown resolve e é mais conhecido. Para manual extenso, com capítulos em arquivos separados, numeração automática, referência cruzada e saída em PDF, o AsciiDoc dá conta sem extensão, enquanto o Markdown precisa de ferramentas em volta.
O GitHub renderiza AsciiDoc?
Renderiza: arquivos .adoc aparecem formatados na interface, incluindo README. O suporte não cobre tudo — inclusão de arquivos, por exemplo, não é resolvida —, mas o essencial da formatação é exibido.

Ferramentas Relacionadas