article Convertidor de Markdown a HTML star

Cómo Funciona

Este convertidor sigue la especificación CommonMark — una versión de Markdown definida con precisión que resuelve las ambigüedades que dejaba abiertas la descripción original de Markdown de 2004 (cómo interactúan las listas anidadas con los párrafos sueltos, qué ocurre cuando un marcador de lista aparece dentro de una cita, etc.). El análisis se realiza en dos pasadas distintas. La primera es a nivel de bloque: el texto se divide en unidades estructurales — párrafos, encabezados ATX (# hasta ######), bloques de código delimitados, citas, listas ordenadas y no ordenadas, líneas horizontales — leyendo solo la estructura de líneas y la sangría, sin mirar todavía el contenido de cada bloque. La segunda pasada es en línea: dentro de cada bloque, el analizador busca marcadores de énfasis (*cursiva*, **negrita**), fragmentos de código en línea (`código`) y sintaxis de enlaces o imágenes ([texto](url)), reescribiéndolos como las etiquetas HTML correspondientes. Este diseño en dos fases explica por qué un asterisco dentro de un bloque de código delimitado queda intacto — los bloques de código se resuelven por completo en la primera pasada, antes de que las reglas de énfasis en línea lleguen a tocar su contenido.

Ejemplo: dado ## Notas de la versión seguido de una línea en blanco y - **v2.1**: correcciones, el análisis a nivel de bloque identifica primero un encabezado y una lista con un elemento; el análisis en línea convierte luego **v2.1** en <strong>v2.1</strong> dentro del <li>. Las tablas siguen la extensión GFM (GitHub Flavored Markdown) añadida sobre CommonMark: una fila de encabezado, una fila separadora --- cuya colocación de dos puntos (:--, :-:, --:) fija la alineación de esa columna, y cualquier número de filas de datos debajo.

Qué Hay que Saber

• El HTML sin procesar se escapa, no se ejecuta — pegar una etiqueta script o un manejador de eventos en línea se muestra como texto visible en lugar de ejecutarse, una elección de seguridad deliberada para contenido pegado o no confiable.
• Las listas sueltas y compactas cambian la salida — una línea en blanco entre elementos de lista obliga a CommonMark a envolver cada elemento en su propio <p> (lista "suelta"); sin líneas en blanco, los elementos se mantienen como contenido en línea plano (lista "compacta"), lo que cambia el espaciado vertical en el HTML resultante.
• El anidamiento muy profundo tiene un límite práctico — cuatro o más niveles de listas anidadas o definiciones de enlaces por referencia son CommonMark válido, pero son casos límite mejor atendidos por un analizador dedicado en tiempo de compilación que por una vista previa en vivo dentro del navegador.