Markdown a HTML

Markdown: escribir documentos con formato sin complicarte la vida

Markdown te permite crear documentos bien formateados usando solo texto plano. Nada de menus, nada de pelear con un procesador de texto. Un # para un titulo, **dobles asteriscos** para negrita, un - para una vineta, y listo. Es el formato de referencia en GitHub, Notion y la mayoria de plataformas de blogging.

Chuleta de Markdown: lo esencial de un vistazo

Lo basico es realmente sencillo. # te da un h1, ## un h2, y asi hasta ######. **negrita** y *cursiva* funcionan exactamente como esperas. Las listas con vinetas empiezan con - o *, las numeradas con 1. 2. 3. Los enlaces se escriben [haz clic aqui](https://example.com), las imagenes igual pero con un ! delante. Para codigo, rodea los fragmentos en linea con backticks y usa tres backticks para bloques de codigo. Las tablas necesitan algo mas de trabajo -- pipes (|) y guiones (-) -- pero son manejables.

Markdown esta literalmente en todas partes

Si usas GitHub, ya estas escribiendo Markdown -- README, issues, descripciones de pull requests, todo va en Markdown. Notion, Obsidian y Slack tambien entienden atajos Markdown. Los generadores de sitios estaticos como Jekyll, Hugo y Astro usan archivos Markdown como fuente de contenido. Documentacion tecnica, blogs, wikis, bases de conocimiento internas -- Markdown se ha convertido en el formato de escritura por defecto en el mundo tech. Merece la pena aprenderlo aunque no seas desarrollador.

Escribir buen Markdown: lo que casi todo el mundo hace mal

No te saltes niveles de titulo -- pasar de # directamente a ### rompe la estructura del documento y confunde a los lectores de pantalla. Pon siempre una linea en blanco entre parrafos (Markdown ignora los saltos de linea simples). En los bloques de codigo, especifica el lenguaje (por ejemplo ```javascript) para activar el resaltado de sintaxis. Para documentos largos, anade una tabla de contenidos -- tus lectores te lo agradeceran. Y previsualiza antes de publicar, porque Markdown puede renderizarse con pequenas diferencias segun la plataforma.