Qué hace
El convertidor de Markdown a HTML transforma texto Markdown en marcado HTML que puedes pegar en un CMS, una plantilla de correo, una página estática o cualquier lugar que acepte HTML pero no Markdown. Es útil para publicar un README en una web, pasar notas a un editor de blog o comprobar exactamente qué etiquetas produce un fragmento de Markdown.
La salida es el mismo HTML que generan los renderizadores de Markdown más populares: encabezados <h1> a <h6>, párrafos <p>, listas <ul> y <ol>, bloques <pre><code> con una clase language- para resaltadores de sintaxis y marcado <table> para las tablas al estilo de GitHub.
Cómo se usa
- Escribe o pega Markdown, sube un archivo
.mdo haz clic en Ejemplo. - Elige las opciones que necesites: GitHub Flavored Markdown, saltos de línea como
<br>, IDs de encabezados para enlaces ancla, saneado para entradas no fiables y un documento HTML completo en lugar de un fragmento. - Copia el HTML o descárgalo como archivo
.html.
El resultado se actualiza mientras escribes. Deja desactivada la opción de documento completo cuando pegues el resultado en una página existente y actívala cuando quieras un archivo independiente.
Ejemplo
Este Markdown:
## Install
Run the **installer** and read the [guide](https://example.com).
- Windows
- macOSse convierte en este HTML:
<h2>Install</h2>
<p>Run the <strong>installer</strong> and read the <a href="https://example.com">guide</a>.</p>
<ul>
<li>Windows</li>
<li>macOS</li>
</ul>Consejos
- Por defecto, el HTML sin procesar dentro del Markdown se mantiene tal cual, como hacen la mayoría de renderizadores. Activa el saneado siempre que el Markdown lo haya escrito otra persona.
- Con los IDs de encabezados activados puedes enlazar a una sección con una dirección como
page.html#instally crear un índice a partir de los encabezados. - Los bloques de código conservan su lenguaje como clase, así que resaltadores como Prism o highlight.js los reconocen sin trabajo extra.
- Para ver el resultado renderizado al lado, usa la vista previa de Markdown. Para el sentido contrario, usa el convertidor de HTML a Markdown.
Preguntas frecuentes
› ¿Qué sintaxis de Markdown se admite?
Todo CommonMark, como encabezados, énfasis, enlaces, imágenes, listas, citas, código y líneas horizontales. Con GitHub Flavored Markdown activado también tienes tablas con alineación de columnas, listas de tareas, tachado y enlaces automáticos para URL sueltas.
› ¿Qué hace la opción de saneado?
Escapa todo el HTML sin procesar del Markdown para que se muestre como texto en lugar de convertirse en etiquetas, y elimina los enlaces e imágenes cuya URL usa un esquema peligroso como javascript o vbscript. Actívala cuando el Markdown venga de usuarios en los que no confías, por ejemplo comentarios o mensajes de foros.
› ¿Cómo se generan los IDs de los encabezados?
Igual que en GitHub. El texto del encabezado pasa a minúsculas, se quitan los signos de puntuación y los espacios se convierten en guiones, así que Getting Started recibe el id getting-started. Los encabezados repetidos reciben -1, -2 y así sucesivamente, de modo que cada ancla es única.
› ¿Para qué sirve la opción de documento HTML completo?
Envuelve el resultado en una página completa con doctype, juego de caracteres UTF-8, etiqueta viewport, un título tomado del primer encabezado de nivel uno y una pequeña hoja de estilos legible. Guárdalo como archivo .html y se abrirá bien en cualquier navegador.
› ¿Se envía mi Markdown a algún sitio?
No. La conversión se ejecuta en tu navegador con la biblioteca marked y no se sube nada a ningún servidor.