Enlaces

Una de las características más importantes de toda página web es la posibilidad de insertar enlaces en el texto. Por ejemplo, un enlace a la Wikipedia.

Todo enlace está formado por dos partes, el texto a mostrar y la dirección URL enlazada. El ejemplo anterior se escribe de la siguiente forma en formato HTML:

... un <a href="https://es.wikipedia.org">enlace a la Wikipedia</a>.

De forma que, el texto a mostrar se delimita entre etiquetas <a>, y la URL enlazada mediante el atributo href en la etiqueta de apertura.

El formato markdown es más simple:

... un [enlace a la Wikipedia](https://es.wikipedia.org).

El texto del enlace se escribe entre corchetes, seguido de la URL entre paréntesis (y sin espacios entre ambos elementos).

Esta forma de escritura tiene una alternativa que permite mantener el texto más limpio. Consiste en sacar las URL fuera de todo párrafo:

Por ejemplo, un [enlace a la Wikipedia].

[enlace a la Wikipedia]: https://es.wikipedia.org
[otro enlace]: https://mipagina.org

Podemos mezclar ambos estilos, y las URLs se pueden poner en cualquier parte del documento. Hay quien prefiere agruparlas al final del archivo. Yo prefiero ponerlas tras cada párrafo donde se utilizan. Nótese que, siguiendo este segundo estilo, las URLs no se escriben entre paréntesis, y el texto del enlace va seguido de dos puntos tras el corchete de cierre.

Enlaces a capítulos

Para crear un enlace a un capítulo del libro, poner el nombre del fichero en lugar de la URL

Véase [capítulo 2](capitulo2.md).

considerando que podemos tener una estructura de carpetas dentro del directorio src:

Véase [capítulo 2](docs/capitulo2.md).

Podemos enlazar directamente a un párrafo de cabecera añadiendo un carácter # y el identificador del párrafo.

Véase [capítulo 2](docs/capitulo2.md#enlaces-a-capítulos).

El identificador se forma transformando el texto de la cabecera a minúsculas y sustituyendo los espacios por guiones.

Mostrar URLS como texto del enlace

Podemos insertar una URL en el texto del documento, delimitándola entre < >. Se usará como texto del enlace y destino, al mismo tiempo.

Para ir a la Wikipedia pulse en <https://es.wikipedia.org>.

Lo que muestra:

Para ir a la Wikipedia pulse en https://es.wikipedia.org.

Espacios en blanco

Es una mala práctica que una URL tenga espacios en blanco, pero a veces pasa:

[link](https://www.ejemplo.com/mi pagina)

Todos los caracteres de un archivo tienen un código, y el del espacio en blanco es %20. Podemos usarlo en este caso:

[link](https://www.ejemplo.com/mi%20pagina)