Markdown a HTML

El convertidor de Markdown a HTML convierte la fuente de Markdown (un README, un registro de cambios, un borrador de blog, un conjunto de notas de la versión) en el HTML que realmente representa un navegador o CMS. Pegue o escriba Markdown a la izquierda y obtendrá HTML semántico a la derecha: los encabezados se vuelven h1-ñona h6, el código vallado se vuelve pre y código con una clase de idioma, las listas se vuelven ul y ol, y las extensiones de GitHub, como tablas, listas de tareas y tachados, se manejan de la misma manera que GitHub los representa.

Markdown es un formato de escritura de texto sin formato, no un formato de visualización. En cualquier lugar donde aparezca en una página (un sitio de documentos, un blog estático, una plantilla de correo electrónico, un campo CMS que solo acepta HTML), algo tiene que compilarlo primero. Hacer eso en el navegador, en lugar de incluir un analizador en su compilación o pegar su borrador en un servicio que no controla, es la forma más rápida de obtener el marcado y seguir adelante.

Todo funciona del lado del cliente. El convertidor es un analizador escrito a mano, no un contenedor alrededor de una API remota, por lo que sus publicaciones inéditas, documentos internos y notas de lanzamiento privados nunca salen de la página. Toggle Markdown con sabor a GitHub, ID de anclaje de encabezado, saltos de línea de una sola nueva línea y transferencia de HTML sin procesar, luego copie el HTML, descargue un archivo .html o tome una tabla de contenido generada.

Markdown permite HTML sin formato en línea, lo que hace que la pregunta de seguridad sea más real que teórica: un documento que contiene una etiqueta de script es Markdown válido y un convertidor que lo pasa produce HTML que se ejecutará cuando se renderiza. La salida aquí se escapa de forma predeterminada por ese motivo, por lo que un archivo Markdown de una fuente que no es de confianza no puede contrabandear el marcado a su página. Si está convirtiendo su propio contenido y desea conservar HTML sin formato, esa es una elección deliberada y no la predeterminada. La otra cosa que hay que saber es que Markdown no tiene una especificación única. Aquí se implementa GitHub Flavored Markdown, que cubre tablas, listas de tareas, código tachado y vallado, y esas son extensiones en lugar de parte de la sintaxis original, por lo que un renderizador estricto de CommonMark no las mostrará.