Encabezados en Markdown

Los encabezados permiten estructurar el contenido en secciones y sub-secciones, facilitando la lectura y organización del documento.

Sintaxis de Encabezados

Markdown admite dos estilos de encabezados: ATX (con almohadillas #) y Setext (con guiones o signos de igual).

Estilo ATX (con #)

Usa de uno a seis signos de almohadilla # seguidos de un espacio y el texto del título:

# Título de nivel 1
## Título de nivel 2
### Título de nivel 3
#### Título de nivel 4
##### Título de nivel 5
###### Título de nivel 6

Visualización Renderizada:

Título de nivel 1

Título de nivel 2

Título de nivel 3

Título de nivel 4

Título de nivel 5

Título de nivel 6

Estilo Setext (Subrayado)

Usa = para nivel 1 y - para nivel 2, debajo del texto:

Título de nivel 1
===============

Título de nivel 2
-----------------

Visualización Renderizada:

Título de nivel 1

Título de nivel 2

Buenas Prácticas

• Usa solo un encabezado de nivel 1 (#) por documento.
• Mantén la jerarquía lógica: no saltes niveles (por ejemplo, de # a ###).
• Añade un espacio después de # para mayor compatibilidad.
• Los encabezados ayudan a generar el índice automático en muchos procesadores Markdown.

Errores Comunes

1. Olvidar el espacio después de #

#Título incorrecto

Esto no se renderizará como encabezado.

2. Saltar niveles de encabezado

# Título principal
### Subtítulo (nivel 3)

Evita saltar del nivel 1 al 3 directamente.

3. Usar demasiados encabezados de nivel 1

# Título 1
# Título 2

Solo debe haber un encabezado de nivel 1 por documento.

Salida HTML

Los encabezados se convierten en etiquetas <h1> a <h6> en HTML:

<h1>Título de nivel 1</h1>
<h2>Título de nivel 2</h2>

Sintaxis Relacionada

• Énfasis - Negrita y cursiva
• Listas - Listas ordenadas y desordenadas
• Enlaces - Crear enlaces

Práctica

1. Crea una estructura de documento con títulos y subtítulos.
2. Usa ambos estilos de encabezado en un mismo archivo.