Convertir Markdown a HTML

Del Markdown a una página web real

Markdown es la forma en que desarrolladores, redactores y quienes toman notas dan formato al texto sin procesador de textos: # para los títulos, asteriscos para el énfasis, guiones para las listas. Es perfecto para escribir, pero los navegadores, las herramientas de correo y muchos editores de CMS necesitan HTML.

Este conversor analiza tu archivo con marked, un motor de Markdown muy extendido, usando GitHub Flavored Markdown. El resultado es un documento HTML5 completo con declaración UTF-8, un título tomado de tu primer encabezado y una pequeña hoja de estilos legible, así que el archivo se ve bien nada más abrirlo con doble clic.

Markdown frente a HTML: comparación rápida

Cómo convertir Markdown a HTML

1. 1

   Paso 1: Elige un archivo .md

   Suelta un README, un archivo de notas o un borrador de blog. ¿Tienes el texto copiado? Guárdalo antes como archivo .md.

2. 2

   Paso 2: Mantén HTML como destino

   HTML está preseleccionado. También están disponibles PDF y TXT.

3. 3

   Paso 3: Convierte

   El Markdown se analiza y se envuelve en una página HTML completa.

4. 4

   Paso 4: Descarga y abre

   Abre el archivo .html en un navegador o copia el contenido del body en tu CMS.

Funciones de Markdown compatibles

Para qué se usa Markdown a HTML

• Publicar notas. Comparte una exportación de Obsidian o Notion como una sola página web.

• Vista previa de README. Mira más o menos cómo se verá un README antes de subirlo.

• Contenido para CMS y newsletters. Pega el HTML generado en editores que aceptan HTML.

• Documentación sin conexión. Da a tus compañeros un archivo que se abre en cualquier navegador.

Cómo es el HTML generado

Los encabezados pasan a ser elementos h1 a h6, las listas ul y ol, las tablas elementos table con celdas de cabecera, y los bloques de código pre y code con una clase como language-js. Los saltos de línea dentro de un párrafo siguen las reglas de Markdown: un salto simple no crea un corte salvo que la línea termine con dos espacios o una barra invertida.

El HTML en bruto que haya dentro de tu Markdown se mantiene tal cual, igual que en GitHub. Es útil para bloques details o inserciones, pero también significa que el resultado es tan seguro como el Markdown de origen.

Usar el resultado en tu propia web

Si solo necesitas el contenido, copia todo lo que hay entre las etiquetas body y pégalo en tu plantilla o CMS. La hoja de estilos incluida es opcional y solo afecta a elementos básicos, así que al quitarla no chocará con los estilos de tu web.

Los enlaces y rutas de imágenes relativos siguen siendo relativos. Mantén el archivo HTML en la misma estructura de carpetas que el Markdown para que las imágenes sigan funcionando.

• Página completa: abre el archivo directamente.
• Fragmento: copia el contenido del body en tu editor.
• Estilos: sustituye la pequeña hoja de estilos integrada por la tuya.

Consejos para archivos Markdown

• Empieza el archivo con un encabezado #: se convierte en el título de la página.
• Deja una línea en blanco antes de listas y tablas para que cualquier analizador las reconozca.
• Usa bloques de código delimitados con el nombre del lenguaje para resaltarlos fácilmente después.
• Revisa los enlaces después de convertir; los enlaces a .md no se reescriben a .html.

Preguntas sobre la conversión de Markdown a HTML