Convertedor de AsciiDoc para Markdown

Converta sintaxe AsciiDoc em Markdown, e vice-versa, diretamente no navegador.

Entrada

DireçãoEstilo de títulosFormato de admoestaçãoManter atributos como front matterEstilo de marcador

Saída

Convertedor de AsciiDoc para Markdown

Cole AsciiDoc — um README, uma página de documentação, uma secção exportada de uma wiki — e esta ferramenta reescreve-a em Markdown. Os títulos (=, ==, até ======) tornam-se # até ######. O texto em negrito (*palavra*) torna-se **palavra**, enquanto o itálico (_palavra_) e o código em linha (`palavra`) já partilham a mesma sintaxe nos dois formatos e passam intactos. link:url[texto] e um url simples https://url[texto] tornam-se [texto](url), image::url[alt] torna-se ![alt](url), um bloco [source,language] entre ---- torna-se um bloco de código entre aspas, e uma tabela |=== torna-se uma tabela Markdown com linha de separação de cabeçalho. As admoestações NOTE, TIP, WARNING, IMPORTANT e CAUTION tornam-se citações ou alertas de estilo GitHub, e toda a operação funciona também ao contrário, de Markdown para AsciiDoc, através da opção de direção.

As outras opções moldam os detalhes: o estilo de título escolhe ATX (#) ou Setext (uma linha de = ou -, apenas nos níveis um e dois — títulos mais profundos voltam a ATX); o formato de admoestação escolhe uma citação simples ou um bloco de alerta GitHub; o estilo de marcador escolhe o travessão ou o asterisco para listas não ordenadas; e manter os atributos como front matter transforma as linhas :nome: valor do AsciiDoc num bloco YAML em vez de as descartar, também espelhado na direção inversa.

Este é um conversor leve baseado em padrões, não um analisador completo, portanto funciona melhor com as construções acima. As listas ordenadas sempre renderizam como "1." ou "." — os renderizadores numeravam sequencialmente independentemente dos dígitos do marcador, pelo que a numeração não é afectada. Os finais de linha Windows e Unix são tratados da mesma forma, e o contador relata linhas de entrada, linhas de saída e elementos convertidos.

Tudo corre localmente no seu navegador enquanto digita — nada do que cola é carregado, registado ou enviado para qualquer local. Copie o resultado, transfira-o como ficheiro .txt ou envie-o de volta para a entrada para outra passagem.

FAQ

Esta ferramenta trata ambas as direções — AsciiDoc para Markdown e Markdown para AsciiDoc?

Sim. A opção de direção alterna qual formato é lido e qual é produzido, e invertê-la também move a saída atual de volta para a entrada, para que possa converter de um lado e depois verificar a viagem de ida e volta.

Porque é que as listas ordenadas sempre aparecem como "1." ou "."?

Tanto os renderizadores Markdown quanto os renderizadores AsciiDoc numeravam sequencialmente, independentemente do dígito ou número de pontos que senta em cada linha de origem, portanto escrever cada marcador da mesma forma ainda produz uma saída numerada correctamente sem que o conversor tenha de rastrear contadores em si.

O que acontece com as construções AsciiDoc que esta ferramenta não reconhece?

Qualquer coisa fora do conjunto suportado — títulos, negrito, ligações, imagens, blocos de listagem, tabelas de uma linha por linha, admoestações, listas e atributos :nome: valor — é deixada em texto simples em vez de ser adivinhada, portanto a saída permanece previsível em vez de silenciosamente estragar a marcação desconhecida.

Pode converter tabelas aninhadas ou multi-linha?

Suporta a forma compacta comum em que cada linha de tabela senta na sua própria linha entre delimitadores |=== (AsciiDoc) ou como uma tabela pipe padrão com linha de separação de cabeçalho (Markdown). As tabelas AsciiDoc escritas com uma célula por linha e separadores de linha em branco não são reconstruídas.

O meu documento é carregado em algum lugar?

Não. A conversão corre inteiramente no seu navegador — nada do que cola sai do seu dispositivo.

Convertedor de AsciiDoc para Markdown

Ferramentas relacionadas

Convertedor de AsciiDoc para Markdown

FAQ