como-usar-encabezados-en-markdown

Cómo utilizar encabezados en Markdown

Markdown permite crear encabezados de varios niveles utilizando el símbolo de almohadilla (#). La cantidad de almohadillas al principio de una línea indica el nivel del encabezado.

Markdown soporta hasta seis niveles de encabezado, del h1 al h6.

# Encabezado de Nivel 1

## Encabezado de Nivel 2

### Encabezado de Nivel 3

#### Encabezado de Nivel 4

#### Encabezado de Nivel 5

#### Encabezado de Nivel 6

Esto se renderiza como:

Encabezado de Nivel 1
Encabezado de Nivel 2
Encabezado de Nivel 3
Encabezado de Nivel 4
Encabezado de Nivel 5
Encabezado de Nivel 6

Espacios después de las Almohadillas

Debe haber un espacio entre las almohadillas y el texto del encabezado para que se renderice correctamente.

Ejemplo incorrecto:

#Encabezado incorrecto

Esto no se renderiza como un encabezado.

#Encabezado incorrecto

Ejemplo correcto:

# Encabezado correcto

Ahora si,

Encabezado correcto

Es un error muy habitual y que os puede volver locos en algún momento, sobre todo si vuestro editor no diferencia los encabezados por colores.

Diferencias entre Encabezados

Encabezados vs. Texto en Negrita

Es importante no confundir los encabezados con texto en negrita. Mientras que los encabezados estructuran el contenido, el texto en negrita se utiliza para resaltar partes específicas dentro del texto.

Ejemplo de negrita:

**Este es un texto en negrita.**

Esto se renderiza como:

Este es un texto en negrita.

Pueden parecer funcionalidades iguales pero no lo son. Los encabezados delimitan zonas, secciones o apartados de un documento. Mientras que la negrita resalta una parte del contenido por ser especialmente relevante

Buenas prácticas Consejos

Consistencia en los Niveles de Encabezado: Mantén una estructura coherente utilizando los niveles de encabezado de manera jerárquica. Empieza con h1 para el título principal, h2 para secciones principales, h3 para subsecciones, y así sucesivamente.

Claridad y Legibilidad: Utiliza encabezados para dividir el contenido en secciones claras y legibles.

Encabezados Descriptivos: Asegúrate de que los encabezados describan claramente el contenido de la sección.

No abusar de los encabezados: Evita el uso excesivo de niveles de encabezado. Generalmente, no es necesario usar h5 o h6 a menos que el documento sea muy complejo.