¿Cómo se manejan los niveles de encabezados entre Markdown y AsciiDoc?

De Markdown a AsciiDoc, los títulos # se desfasan a == para reservar el nivel = como título del documento, a menos que actives la promoción directa del primer H1.

¿Qué ocurre con los bloques de código y el resaltado de sintaxis?

Los bloques delimitados por comillas triples en Markdown se transforman en estructuras [source,lang] con delimitadores ---- en AsciiDoc y viceversa.

¿Cómo se convierten las notas y advertencias (admoniciones)?

Se mapean bidireccionalmente entre las alertas de GitHub (> [!NOTE], > [!WARNING]) y las etiquetas estándar de AsciiDoc (NOTE:, WARNING:, TIP:, IMPORTANT:, CAUTION:).

¿Cómo se tratan las directivas específicas de AsciiDoc al convertir a Markdown?

Las directivas como include::, atributos de documento y condiciones se degradan a comentarios HTML acompañados de un aviso para evitar pérdidas silenciosas.

¿La conversión garantiza una equivalencia idéntica en viajes de ida y vuelta?

No. La herramienta prioriza una migración directa y precisa de una sola dirección, ya que ambos formatos poseen extensiones sin equivalencia perfecta.

Elysia Tools

Navegación

Format Conversion

Conversor Markdown ⇄ AsciiDoc

Convierte entre Markdown estilo GitHub y AsciiDoc (el formato estándar de Antora, Red Hat y Asciidoctor): desfase automático de niveles de títulos (= es el título del documento en AD), inversión del orden de corchetes en enlaces, bloques de código ⇄ [source], tablas GFM ⇄ |===, admoniciones NOTE/TIP/WARNING, listas de tareas, notas al pie, anclas y referencias cruzadas, saltos de línea duros; las construcciones sin equivalente perfecto se listan como avisos.

Detalles

Qué te ayuda a hacer esta herramienta

El conversor es un analizador de bloques línea a línea más un tokenizador de énfasis en línea, sin dependencias, en ambas direcciones. Reglas clave: MD #/## → AD ==/=== (salvo promoción del primer H1 a = como título); texto se invierte a url[texto], y las URL con paréntesis o guiones bajos se envuelven en ++…++ para evitar cursivas accidentales; las vallas ``` → [source,lang] + ----; las tablas GFM → |=== con options="header" y el alineamiento :--- en el colspec; las citas > → bloque [quote] con [quote, autor]; NOTE:/TIP:/IMPORTANT:/WARNING:/CAUTION: ⇄ alerta de GitHub > [!NOTE]; listas de tareas, notas al pie, [[anclas]], <>, saltos duros (dos espacios finales ⇄ + final) y reglas horizontales. La dirección AD→MD degrada include::, atributos {x} y condicionales a comentarios HTML con aviso. No se promete ida y vuelta sin pérdidas; el objetivo es la corrección de una única migración.

Ejecución

Ejecutar esta herramienta

Completa el formulario, ejecuta la herramienta y revisa el resultado en un solo lugar.

Ejemplos

Ejemplos que encajan con esta herramienta

Relacionado

Conversor Markdown ⇄ AsciiDoc

Qué te ayuda a hacer esta herramienta

Ejecutar esta herramienta

Ejemplos que encajan con esta herramienta

Continuar con herramientas y temas relacionados

Conoce cuándo usar esta herramienta, qué admite y cómo la aplican los usuarios.

Datos clave

Resumen

Cuándo usarlo

Cómo funciona

Casos de uso

Ejemplos

1. Migración de notas de versión de Markdown a AsciiDoc

2. Conversión de manual AsciiDoc a README en Markdown

Preguntas frecuentes

Ejemplos de Markdown

Muestras de Visor Markdown

Ejemplos de Presentaciones Markdown

Muestras PDF

Convertidor Markdown a HTML

Markdown a Texto Plano

Tarjeta de especificación responsive Figma iOS Android pt dp sp

Comparador de algoritmos hash