Cabeceras

Los párrafos de cabecera se muestran con un tipo de letra resaltado. Se usan como título de capítulo, sección, subsección, etcétera.

En formato HTML podemos tener hasta seis niveles de resaltado:

<h1>Título nivel 1</h1>

<h2>Título nivel 2</h2>

<h3>Título nivel 3</h3>

<h4>Título nivel 4</h4>

<h5>Título nivel 5</h5>

<h6>Título nivel 6</h6>

<p> Texto regular </p>

Lo que muestra:

Título nivel 1

Título nivel 2

Título nivel 3

Título nivel 4

Título nivel 5

Título nivel 6

Texto regular

El tamaño de letra, presentación, etcétera, se puede ajustar con hojas de estilo CSS. Lo que vemos en este ejemplo se muestra de acuerdo a los estilos aplicados a este cuaderno:

h1 { font-size: 3em;}

h2 { border-bottom: 1px solid teal;}

h3 { font-style: italic; }

En formato markdown, las cabeceras se señalan como párrafos de una única línea de texto, precedidos por tantos símbolos # como nivel deseemos:

# Título nivel 1

## Título nivel 2

### Título nivel 3

####Título nivel 4

##### Título nivel 5

###### Título nivel 6

Texto regular

A este formato se le denomina “atx”. Entre los símbolos # y el texto se suele dejar algún espacio. Esto depende de cada versión de markdown, pero se recomienda respetar por compatibilidad. También es costumbre dejar una línea en blanco antes y después de cada cabecera.

Podemos añadir cualquier número de caracteres # a la derecha del título, que serán ignorados:

# Título nivel1 ###########

## Título nivel2 ##########

Texto regular

Estilo “setext”

Como alternativa al formato “atx”, podemos usar el estilo “setext”, limitado a dos niveles:

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

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

Texto regular.

En estilo setext las cabeceras de nivel 1 se subrayan con símbolos =, y las de nivel 2, con símbolos -. El número de caracteres que forman el subrayado no tiene por que coincidir con el tamaño del texto, y este puede ser multilínea:

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

A tener en cuenta

Podría ser tentador definir un párrafo como cabecera solo para resaltarlo, pero esta es una mala práctica.

Las cabeceras no se limitan a aplicar un tipo de letra especial. Proporcionan una estructura al documento, y los motores de búsqueda las utilizan para indexar los contenidos. Además, mdBook las utiliza para generar el índice de la barra lateral.

Las cabeceras <h1> deberían utilizarse para el título del documento, seguidas de las <h2> y así sucesivamente. No debemos usar estas etiquetas solo para resaltar texto en negrita o mostrarlo más grande. Para ese propósito tenemos las hojas de estilo.