Elysia Tools

Explora herramientas, ejemplos, explicaciones visuales y guías temáticas en un solo espacio claro.

Categorías populares

Temas

Idioma
ZHDERUPTENFRES

Elysia Tools

Navegación

Format Conversion

Conversor Markdown ⇄ AsciiDoc

· Última actualización:2026-08-22

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

Continuar con herramientas y temas relacionados

Escrito por el equipo de Elysia Tools

Guía de uso de la herramienta

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

Datos clave

Categoría
Format Conversion
Tipos de entrada
select, textarea, checkbox
Tipo de salida
html
Cobertura de ejemplos
4
API disponible
Sí

Resumen

Convierte documentación técnica bidireccionalmente entre Markdown de GitHub y AsciiDoc para Antora o Asciidoctor, adaptando de forma precisa encabezados, tablas, bloques de código, avisos y enlaces.

Cuándo usarlo

  • Al migrar documentación existente de repositorios GitHub en Markdown hacia sitios estáticos basados en Antora o Asciidoctor.
  • Al adaptar guías técnicas redactadas en AsciiDoc para publicarlas en wikis o plataformas que solo admiten Markdown.
  • Al transformar notas de lanzamiento, tablas GFM y bloques de código entre ambos formatos sin reescribir manualmente la sintaxis de marcado.

Cómo funciona

  1. 1Selecciona la dirección de conversión deseada: Markdown a AsciiDoc o AsciiDoc a Markdown.
  2. 2Pega el texto del documento en el área de entrada y ajusta las casillas para promover el primer H1 a título de documento o conservar advertencias de elementos no resueltos.
  3. 3El analizador procesa la estructura línea a línea, transformando bloques (tablas, código, citas, listas) y elementos en línea (enlaces, estilos de texto, anclas).
  4. 4Obtén el contenido convertido listo para copiar o integrar en tu flujo de publicación técnica.

Casos de uso

  • Migración de bases de conocimiento y documentación técnica de repositorios Git a portales centralizados en Antora.
  • Conversión de especificaciones técnicas redactadas en AsciiDoc a archivos README.md compatibles con GitHub.
  • Reutilización rápida de tablas de datos y fragmentos de código entre editores que utilizan diferentes estándares de marcado.

Ejemplos

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

Ingeniero de Documentación Técnica

Contexto

El equipo redacta notas de lanzamiento en Markdown dentro de GitHub y necesita publicarlas en el portal de documentación empresarial montado en Antora.

Problema

Reescribir manualmente tablas con alineación, listas de tareas y llamadas de atención NOTE a sintaxis AsciiDoc consume tiempo y genera errores de formato.

Cómo usarlo

Pega el texto Markdown de la versión, marca la opción 'Promover el primer H1 a título de documento' y selecciona la dirección 'Markdown → AsciiDoc'.

direction: md2ad, promoteTitle: true, keepUnresolved: true

Resultado

El documento resultante contiene el título principal con =, tablas |=== con opciones de cabecera y bloques [source,python] listos para compilar.

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

Desarrollador de Software

Contexto

Un proyecto de código abierto cuenta con documentación en formato AsciiDoc pero requiere un README.md legible en la portada de su repositorio.

Problema

Las macros de enlaces tipo link:url[texto] y las advertencias NOTE: no se visualizan correctamente en el renderizador predeterminado de GitHub.

Preguntas frecuentes

¿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.

Inicio
Herramientas3212
Ejemplos593
Visualizaciones471
Visores de archivos103
Temas239
Etiquetas333
Imágenes, audio y video657

Herramientas de procesamiento, conversión y optimización de imágenes, audio y video

Matemáticas, fechas y finanzas647

Calculadoras, herramientas numéricas, lógica de fechas, estadística y finanzas

Diseño y color298

Herramientas de color, maquetación, gráficos, estilo visual y apoyo al diseño

Texto y redacción209

Herramientas de redacción, limpieza, formato, extracción y análisis de texto

Desarrollo y Web193

Utilidades para desarrolladores, red, depuración web y automatización

Conversión y codificación175

Herramientas de conversión de formatos, archivos, unidades, archivos comprimidos y codificación

Lanzamiento de un cuestionario de captación y entrega de contactos
Textos conmemorativos: revisión familiar y entrega para impresión
Hábitos privados: copia, restauración y revisión antes de compartir
De artículo a borradores de X y LinkedIn: revisión factual y entrega
Revisión de una lección Markdown interactiva y entrega sin conexión

© 2026 Elysia Tools. Todos los derechos reservados.

DocumentaciónPreciosAcerca deTérminos de servicioPolítica de privacidadCookiesContacto
Formatos de datos

Ejemplos de Markdown

Ejemplos de formato Markdown desde estructuras simples hasta complejas

Documentos

Muestras de Visor Markdown

Muestras Markdown para vista previa de README, renderizado de documentacion y pruebas de marcado

Documentación

Ejemplos de Presentaciones Markdown

Mazos Markdown estilo Remark/Marp para probar la exportacion a PDF

Documentos

Muestras PDF

Muestras PDF generadas por herramientas 2026-02-01 a 2026-02-10

Format Conversion

Convertidor Markdown a HTML

Convierte texto Markdown a HTML con opciones de formato personalizables

Format Conversion

Markdown a Texto Plano

Convertir texto formateado Markdown a texto plano eliminando toda la sintaxis y formato Markdown

Design

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

Convierte valores px de Figma a las unidades correctas por plataforma y genera una spec card para desarrolladores: pt de iOS (@1x/@2x/@3x con px renderizado por escala), dp/sp de Android (tabla de renderizado mdpi…xxxhdpi y escala de fuente), rem/vw web con snippet clamp() fluido; audita objetivos táctiles mínimos (44pt iOS / 48dp Android / 44px y 24px WCAG) y anota clases de ventana de Material y breakpoints de Tailwind.

Cryptography

Comparador de algoritmos hash

Aplica MD5, SHA-1, SHA-256, SHA-512, BLAKE2b y BLAKE3 a la misma entrada y compáralos lado a lado: longitud de salida, digest hex/Base64, estado de seguridad (roto/moderno) y benchmark de velocidad relativa. Útil para enseñanza, elegir algoritmo o verificar checksums.

Cómo usarlo

Pega el contenido del manual en AsciiDoc, establece la dirección en 'AsciiDoc → Markdown' y copia el Markdown generado.

direction: ad2md, promoteTitle: false, keepUnresolved: true

Resultado

Se obtiene un archivo Markdown con enlaces [texto](url), citas de alerta compatibles con GitHub y tablas tabulares GFM.