¿Qué es Markdown? Una explicación completa del lenguaje de marcado ligero
Respuesta rápida
Markdown es un lenguaje de marcado de texto plano que utiliza símbolos simples para dar formato al texto: # para encabezados, ** para negrita, * para cursiva, - para listas, [texto](url) para enlaces. Está diseñado para ser legible como texto plano y convertible a HTML. Utilice nuestro convertidor gratuito de Markdown a HTML para representar Markdown en su navegador.
Introducción
Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004 que utiliza formato de texto sin formato para producir documentos estructurados. El objetivo es la legibilidad: el texto fuente de Markdown debe verse como lo que representa, sin el desorden visual de las HTML etiquetas. Markdown es el estándar para archivos README en GitHub, sitios de documentación, publicaciones de blogs, comentarios en plataformas como Reddit y Stack Overflow y aplicaciones para tomar notas como Obsidian y Notion. Markdown se convierte a HTML para publicación web.
Paso a paso
-
Aprende la sintaxis básica
Encabezados: # H1, ## H2, ### H3. Negrita: **texto**. Cursiva: *texto*. Listas: - artículo o 1. artículo. Enlaces: [texto](url). Imágenes: . Código: `inline` o ```block```. Citas en bloque: > cita. Regla horizontal: ---.
-
entender la filosofia
Markdown está diseñado para ser legible como texto sin formato. La fuente debe parecerse a la salida final renderizada: **negrita** parece negrita, # Título parece un título. Esto contrasta con HTML, donde la <strong>negrita</strong> y el <h1>título</h1> están visualmente desordenados.
-
Aprende las variantes
El descuento original (especificación de Gruber) es mínimo. CommonMark es una versión estandarizada y bien especificada. GitHub Flavored Markdown (GFM) agrega tablas, tachados, listas de tareas y enlaces automáticos. MDX le permite incrustar componentes de React en Markdown. La mayoría de las herramientas son compatibles con GFM.
-
Convertir rebajas a HTML
Markdown se convierte a HTML para publicación web. # Hola se convierte en <h1>Hola</h1>, **negrita** se convierte en <strong>negrita</strong>. Los generadores de sitios estáticos (Astro, Hugo, Jekyll) convierten Markdown en el momento de la compilación. Utilice nuestro convertidor Markdown a HTML para una conversión instantánea.
Ejemplos
Encabezado y párrafo
Aporte: # Título
Un párrafo.
Producción: <h1>Title</h1>
<p>A paragraph.</p>
Negrita y cursiva
Aporte: **negrita** y *cursiva*
Producción: <strong>bold</strong> and <em>italic</em>
Enlace e imagen
Aporte: [text](https://example.com) and 
Producción: <a href="https://example.com">text</a> and <img src="image.png" alt="alt">
Problemas comunes
- Saltos de línea: una sola nueva línea en Markdown no crea un salto de línea en HTML. Utilice dos espacios al final de una línea o dos nuevas líneas para un salto de párrafo.
- Listas anidadas: la sangría importa. Utilice 2 o 4 espacios de forma consistente para elementos anidados; mezclarlos puede romper la estructura de la lista.
- HTML sin formato: la mayoría de los analizadores de Markdown pasan por HTML sin formato, pero algunos lo desinfectan. Verifique el comportamiento de su analizador si incrusta HTML directamente.
- Diferentes sabores: Original Markdown, CommonMark y GFM tienen diferencias sutiles. Compruebe qué versión admite su plataforma de destino.
Consejos
- Utilice Markdown para escribir y documentar; es mucho más fácil de leer y escribir que HTML.
- GitHub Flavored Markdown (GFM) es la variante más común: agrega tablas, tachados y listas de tareas.
- Escriba en Markdown y conviértalo a HTML en el momento de la compilación para blogs y sitios de documentación.
- Utilice nuestro convertidor de Markdown a HTML para representar Markdown instantáneamente en su navegador.