Markdown a HTML
Convierte Markdown en HTML
Acerca de Markdown a HTML
Markdown a HTML convierte Markdown en un archivo HTML5 listo para guardar, o en un fragmento HTML para pegar en una página. El texto lo lee marked con GitHub Flavored Markdown activado (tablas, listas de tareas, texto tachado, y direcciones escritas tal cual que se vuelven enlaces), y las notas al pie escritas [^1] se numeran y se listan al final. Por defecto, el resultado se coloca dentro de un doctype, un elemento html, un head que declara la codificación UTF-8 y un body; «Título», «Idioma (lang)» y «Estilos básicos» añaden un título, un atributo lang y una hoja de estilos, y «Fragmento HTML (solo el body)» en «Salida» quita esa envoltura. Los bloques de código conservan su lenguaje como clase (language-js) y los caracteres como < dentro del código se escapan. El HTML sin procesar de tu Markdown se copia sin cambios, scripts incluidos, salvo si marcas «Quitar scripts y controladores de eventos», que limpia el HTML con DOMPurify. «Vista previa» muestra la página tal como la dibuja un navegador, con los scripts bloqueados. El Markdown se puede pegar o abrir desde un archivo .md, .markdown o .txt.
Ejemplo
Salida del propio código de conversión de la página para un título, código en línea y un bloque JavaScript delimitado.
Markdown
# Notas Usa `a < b` en el **código**. ```js if (a < b) run(); ```
Salida HTML
<!DOCTYPE html> <html> <head><meta charset="utf-8"></head> <body> <h1>Notas</h1> <p>Usa <code>a < b</code> en el <strong>código</strong>.</p> <pre><code class="language-js">if (a < b) run(); </code></pre> </body> </html>
Cómo convertir Markdown en un archivo HTML
- 1Pega tu Markdown en el cuadro «Markdown», o haz clic en «Abrir un archivo» para cargar un archivo .md, .markdown o .txt.
- 2Elige la «Salida» y, para un documento completo, rellena «Título» e «Idioma (lang)» o marca «Estilos básicos»; luego marca las casillas que necesites, como «Notas al pie» o «Quitar scripts y controladores de eventos».
- 3Haz clic en «Convertir», que se activa en cuanto el cuadro deja de estar vacío.
- 4Revisa el código en «Salida HTML» y la página en «Vista previa», y luego haz clic en «Copiar» o usa «Descargar» para guardarlo como document.html.
Formatos y límites
- Entrada
- Texto Markdown, pegado o abierto desde un archivo .md, .markdown o .txt, leído con las reglas de CommonMark y GitHub Flavored Markdown, notas al pie incluidas
- Salida
- Un documento HTML: doctype, un head que declara la codificación UTF-8 y body, con el título, el atributo lang y los estilos básicos que elijas; o solo el HTML del body
- Extensiones
- Tablas, listas de tareas, texto tachado y direcciones convertidas en enlaces (GitHub Flavored Markdown, se puede desactivar); notas al pie; id de los títulos; saltos de línea simples conservados como elementos br si se pide
- HTML sin procesar
- Se copia tal como está escrito, o lo limpia DOMPurify cuando «Quitar scripts y controladores de eventos» está marcado
- Descarga
- document.html
Dónde se convierte tu Markdown
La conversión se hace en tu navegador: la biblioteca marked se descarga la primera vez que haces clic en Convertir, DOMPurify la primera vez que limpias el HTML, y ni tu Markdown ni el HTML resultante se envían nunca a nuestros servidores. En la vista previa, las imágenes a las que enlaza tu Markdown se cargan desde sus propios sitios, como al abrir el archivo. Si aparece un error en el cuadro de salida, su mensaje limpio se envía a nuestro registro de errores con el nombre de la herramienta y el nombre y la versión de tu navegador, sin los textos citados ni las direcciones, para que podamos corregir el problema.
Preguntas frecuentes
¿La salida incluye una página HTML completa?
Sí. El HTML se coloca dentro de un doctype, un elemento html, un head que declara la codificación UTF-8 y un body, para que las letras con tilde se vean bien al abrir el archivo. Rellena «Título» e «Idioma (lang)», o marca «Estilos básicos», para añadirlos; elige «Fragmento HTML (solo el body)» en «Salida» para obtener solo el HTML del body.
¿Se conserva el HTML sin procesar de mi Markdown?
Sí, tal como está escrito, salvo si marcas «Quitar scripts y controladores de eventos»: si no, un elemento script o un atributo onclick de tu Markdown termina en el archivo. Con la casilla marcada, DOMPurify los quita, junto con los enlaces javascript:. En ningún caso la vista previa ejecuta scripts.
¿Es segura la vista previa con un HTML del que no me fío?
Sí. La vista previa se muestra en un marco aislado donde ni los scripts ni los controladores de eventos pueden ejecutarse, contenga lo que contenga el HTML. El archivo que descargas es otra cosa: marca «Quitar scripts y controladores de eventos» antes de convertir si el Markdown viene de otra persona.
¿Se admiten las notas al pie?
Sí. Escribe una llamada como [^1] en el texto y su nota en una línea aparte, como [^1]: La fuente. Las llamadas se convierten en enlaces numerados, y las notas se listan al final en una sección de clase footnotes, cada una con un enlace ↩ a su llamada. Desmarca «Notas al pie» para dejar esos corchetes como texto.
¿Los bloques de código tienen resaltado de sintaxis?
No. Un bloque delimitado marcado como js se convierte en un elemento pre y code con la clase language-js, listo para un resaltador como Prism o highlight.js, pero aquí no se añaden colores.
¿Puedo convertir directamente un archivo .md?
Sí. Haz clic en «Abrir un archivo» y elige un archivo .md, .markdown o .txt; su texto se carga en el cuadro Markdown, y el resultado se puede guardar después con el botón Descargar.
Consejos y trucos
- ✓Marca «Anclas de los títulos (id)» para dar un id a cada título, como hace GitHub, de modo que un enlace como #installation lleve directamente a él.