# 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. > Página canónica: https://elysiatools.com/es/tools/markdown-asciidoc-converter - **Categoría:** Format Conversion - **Palabras clave:** markdown a asciidoc, asciidoc a markdown, migración antora, convertir asciidoctor, conversor de documentación ## Descripción general 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\](url) 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. ## Entradas - **Dirección de conversión** (select) - **Documento origen** (textarea): Paste your Markdown (or AsciiDoc when converting back)… - **Promover el primer H1 a título de documento** (checkbox) - **Mantener visible el marcado sin equivalente** (checkbox) ## 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 - Selecciona la dirección de conversión deseada: Markdown a AsciiDoc o AsciiDoc a Markdown. - Pega 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. - El 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). - Obté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. ## 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. ## Herramientas relacionadas - [Convertidor Markdown a HTML](https://elysiatools.com/es/tools/markdown-to-html): Convierte texto Markdown a HTML con opciones de formato personalizables - [Markdown a Texto Plano](https://elysiatools.com/es/tools/markdown-to-plain-text): Convertir texto formateado Markdown a texto plano eliminando toda la sintaxis y formato Markdown - [Tarjeta de especificación responsive Figma iOS Android pt dp sp](https://elysiatools.com/es/tools/figma-ios-android-pt-dp-sp-responsive-design-spec-card): 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. - [Comparador de algoritmos hash](https://elysiatools.com/es/tools/hash-algorithm-comparator): 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. - [Descomponedor de árbol OKR y KPI](https://elysiatools.com/es/tools/okr-tree-decomposer): Descompone un Objective de empresa en Departamento → Equipo → Personal, con peso/meta/actual por nodo; el progreso ponderado sube al nivel superior. Árbol visual + Markdown. - [AI Imagen a Markdown](https://elysiatools.com/es/tools/ai-image-to-markdown): Extraer texto de imágenes y convertir a formato markdown usando modelos de visión AI - [Calculadora de Anión Gap Sérico (AG)](https://elysiatools.com/es/tools/anion-gap-calculator): Calcula el anión gap sérico AG = Na⁺ − Cl⁻ − HCO₃⁻ (mmol/L), con opción de la fórmula con K⁺ y corrección por albúmina. AG elevado (≈ >12) sugiere acumulación de aniones no medidos (lactato, cuerpos cetónicos, metanol/etilenglicol, salicilatos, insuficiencia renal; nemotecnia GOLD-MARK). Acidosis metabólica con AG normal (8–12) es hiperclorémica: diarrea, acidosis tubular renal, infusión de salino. AG bajo (<3–6) suele ser hipoalbuminemia; también hipercalcemia/hipermagnesemia, litio, mieloma IgG (paraproteínas catiónicas), bromuro/pseudohipercloremia. En hipoalbuminemia use la corrección AG_corr = AG + 2.5×(4.0 − albúmina). Fuentes: Kraut CJASN 2007, Figge 1998, MDCalc. Interpretar con gases y clínica. No es consejo médico. - [Lista Indentada a Árbol ASCII](https://elysiatools.com/es/tools/ascii-tree-from-indented-list): Convierte una lista jerárquica indentada (2/4 espacios o tabulación; prefijos -, *, 1. opcionales) en un árbol de directorios ASCII copiable. Dos estilos: cuadro Unicode y ASCII clásico. Interruptores para líneas guía completas, espacios finales y hojas entre corchetes. ## Ejemplos - [Ejemplos de Markdown](https://elysiatools.com/es/samples/markdown-samples): Ejemplos de formato Markdown desde estructuras simples hasta complejas - [Muestras de Visor Markdown](https://elysiatools.com/es/samples/markdown-viewer-samples): Muestras Markdown para vista previa de README, renderizado de documentacion y pruebas de marcado - [Ejemplos de Presentaciones Markdown](https://elysiatools.com/es/samples/md-slide-deck-to-pdf): Mazos Markdown estilo Remark/Marp para probar la exportacion a PDF - [Muestras PDF](https://elysiatools.com/es/samples/pdf-samples): Muestras PDF generadas por herramientas 2026-02-01 a 2026-02-10