# Conversor Markdown ⇄ AsciiDoc

Converta nos dois sentidos entre Markdown (sabor GitHub) e AsciiDoc (o formato padrão do Antora, Red Hat e Asciidoctor): deslocamento automático dos níveis de títulos (= é o título do documento em AD), inversão da ordem dos colchetes nos links, blocos de código ⇄ [source], tabelas GFM ⇄ |===, admoestações NOTE/TIP/WARNING, listas de tarefas, notas de rodapé, âncoras e referências cruzadas, quebras de linha duras; construções sem equivalente perfeito são listadas como avisos.

> Página canônica: https://elysiatools.com/pt/tools/markdown-asciidoc-converter

- **Categoria:** Format Conversion

- **Palavras-chave:** markdown para asciidoc, asciidoc para markdown, migração antora, converter asciidoctor, conversor de documentação

## Visão geral

O conversor é um parser de blocos linha a linha mais um tokenizador de ênfases inline, sem dependências, nas duas direções. Regras-chave: MD #/## → AD ==/=== (exceto a promoção do primeiro H1 a título =); \[texto\](url) vira url\[textо\], URLs com parênteses ou sublinhados são envolvidas em ++…++; cercas \`\`\` → \[source,lang\] + ----; tabelas GFM → |=== com options="header" e o alinhamento :--- no colspec; citações > → bloco \[quote\] com \[quote, autor\]; NOTE:/TIP:/IMPORTANT:/WARNING:/CAUTION: ⇄ GitHub-Alert > \[!NOTE\]; listas de tarefas, notas de rodapé, \[\[âncoras\]\], <\>, quebras duras e réguas horizontais. A direção AD→MD degrada include::, atributos {x} e condicionais em comentários HTML com aviso. Ida-e-volta sem perdas não é prometido — o alvo é a correção de uma única migração.

## Entradas

- **Direção da conversão** (select)
- **Documento de origem** (textarea): Paste your Markdown (or AsciiDoc when converting back)…
- **Promover o primeiro H1 a título do documento** (checkbox)
- **Manter visível a marcação sem equivalente** (checkbox)

## Quando usar

- Migrar documentações e repositórios do formato Markdown para geradores de sites estáticos baseados em AsciiDoc como o Antora.
- Converter manuais, especificações técnicas e arquivos .adoc para visualização direta em repositórios e wikis no GitHub ou GitLab.
- Padronizar tabelas com alinhamento de colunas, admoestações de aviso e referências cruzadas entre equipes com fluxos de documentação distintos.

## Como funciona

- Selecione a direção da conversão desejada: Markdown → AsciiDoc ou AsciiDoc → Markdown.
- Cole o documento de origem no campo de texto principal e ajuste as opções de promoção de títulos e tratamento de elementos não mapeados.
- O analisador processa a hierarquia de seções, blocos estruturais (tabelas, citações, código) e marcadores inline (links, tarefas e notas de rodapé).
- Copie o resultado convertido pronto para uso diretamente do painel de saída.

## Casos de uso

- Migração de bases de conhecimento e guias de desenvolvedor de Markdown para portais corporativos mantidos em Antora.
- Adaptação de changelogs e notas de versão gerados automaticamente no GitHub para publicação em documentações Asciidoctor.
- Transformação de especificações arquiteturais escritas em AsciiDoc em arquivos README.md para repositórios públicos.

## Perguntas frequentes

### Como os níveis de títulos são convertidos entre os formatos?

Na conversão de Markdown para AsciiDoc com promoção ativada, o primeiro H1 vira o título do documento (=) e os demais títulos (#, ##) são deslocados para níveis de seção (==, ===).

### Como são tratadas as caixas de alerta como NOTE, TIP e WARNING?

Admoestações do AsciiDoc são convertidas para alertas nativos do GitHub (> [!NOTE]), e alertas em Markdown retornam como blocos de admoestação padrão no AsciiDoc.

### O que acontece com recursos exclusivos do AsciiDoc como include:: e atributos?

Diretivas sem equivalente direto no Markdown são preservadas e rebaixadas para comentários HTML visíveis para evitar perda de contexto.

### As tabelas com alinhamento de colunas funcionam nos dois sentidos?

Sim, tabelas GFM com alinhamentos (:---, :---:) são mapeadas para tabelas |=== com especificações de coluna [cols] e cabeçalhos em AsciiDoc, e vice-versa.

### URLs com sublinhados ou parênteses quebram a formatação em AsciiDoc?

Não, URLs contendo caracteres especiais são envolvidas automaticamente em marcadores de escape (++...++) para não acionar estilos de itálico indesejados.

## Ferramentas relacionadas

- [Conversor Markdown para HTML](https://elysiatools.com/pt/tools/markdown-to-html): Converte texto Markdown para HTML com opções de formato personalizáveis
- [Markdown para Texto Puro](https://elysiatools.com/pt/tools/markdown-to-plain-text): Converter texto formatado Markdown para texto puro removendo toda sintaxe e formatação Markdown
- [Cartão de especificação responsiva Figma iOS Android pt dp sp](https://elysiatools.com/pt/tools/figma-ios-android-pt-dp-sp-responsive-design-spec-card): Converte valores px do Figma para as unidades corretas de cada plataforma e gera um spec card para devs: pt do iOS (@1x/@2x/@3x com px renderizados por escala), dp/sp do Android (tabela de renderização mdpi…xxxhdpi e escala de fonte), rem/vw web com snippet clamp(); auditoria de alvos de toque mínimos (44pt iOS / 48dp Android / 44px e 24px WCAG) com classes de janela do Material e breakpoints do Tailwind.
- [Comparador de algoritmos de hash](https://elysiatools.com/pt/tools/hash-algorithm-comparator): Aplica MD5, SHA-1, SHA-256, SHA-512, BLAKE2b e BLAKE3 à mesma entrada e compara: tamanho, digest hex/Base64, status de segurança (quebrado/moderno) e benchmark de velocidade relativa. Útil para ensino, escolha de algoritmo ou checagem de checksums.
- [Decompositor de árvore OKR e KPI](https://elysiatools.com/pt/tools/okr-tree-decomposer): Decompõe um Objective de empresa em Departamento → Equipe → Pessoal, com peso/meta/atual por nó; o progresso ponderado sobe. Árvore visual + Markdown.
- [IA Imagem para Markdown](https://elysiatools.com/pt/tools/ai-image-to-markdown): Extrair texto de imagens e converter para formato markdown usando modelos de visão IA
- [Calculadora de Anion Gap Sérico (AG)](https://elysiatools.com/pt/tools/anion-gap-calculator): Calcula o anion gap sérico AG = Na⁺ − Cl⁻ − HCO₃⁻ (mmol/L), com opção da fórmula com K⁺ e correção por albumina. AG elevado (≈ >12) sugere acúmulo de ânions não medidos (lactato, corpos cetônicos, metanol/etilenoglicol, salicilatos, insuficiência renal; mnemônico GOLD-MARK). Acidose metabólica com AG normal (8–12) é hiperclorêmica: diarreia, acidose tubular renal, infusão de salino. AG baixo (<3–6) geralmente por hipoalbuminemia; também hipercalcemia/hipermagnesemia, lítio, mieloma IgG (paraproteínas catiônicas), brometo/pseudo-hiperloremia. Em hipoalbuminemia use a correção AG_corr = AG + 2.5×(4.0 − albumina). Fontes: Kraut CJASN 2007, Figge 1998, MDCalc. Interpretar com gases e clínica. Não é conselho médico.
- [Lista Indentada para Árvore ASCII](https://elysiatools.com/pt/tools/ascii-tree-from-indented-list): Converte uma lista hierárquica indentada (2/4 espaços ou tab; prefixos -, *, 1. opcionais) em uma árvore de diretórios ASCII copiável. Dois estilos: caixa Unicode e ASCII clássico. Opções para linhas guia completas, espaços finais e folhas entre colchetes.

## Exemplos

- [Exemplos de Markdown](https://elysiatools.com/pt/samples/markdown-samples): Exemplos de formato Markdown de estruturas simples a complexas
- [Amostras do Visualizador Markdown](https://elysiatools.com/pt/samples/markdown-viewer-samples): Amostras Markdown para visualizacao de README, renderizado de documentacao e testes de marcacao
- [Exemplos de Apresentacoes Markdown](https://elysiatools.com/pt/samples/md-slide-deck-to-pdf): Decks Markdown estilo Remark/Marp para testar exportacao em PDF
- [Exemplos PDF](https://elysiatools.com/pt/samples/pdf-samples): Exemplos PDF gerados por ferramentas de 2026-02-01 a 2026-02-10