como-usar-enlaces-en-markdown

Cómo usar enlaces en Markdown

En Markdown los enlaces son una herramienta clave para facilitar la navegación, proporcionar referencias, y enriquecer la experiencia del lector.

Los enlaces pueden ser

  • Internos, dirigiendo a otras secciones dentro del mismo documento (o de la misma web)
  • Externos, llevando al lector a sitios web o recursos externos

Enlaces externos

Los enlaces externos permiten a los lectores acceder a recursos fuera del documento, como sitios web, artículos, o bases de datos relevantes.

Para crear un enlace externo en Markdown, se utiliza la siguiente sintaxis:

[Texto del Enlace](URL-del-enlace)

Por ejemplo este fragmento de Markdown,

[www.luisllamas.es](https://www.luisllamas.es)

Esto se renderiza como:

Enlaces con texto y descripción

A veces, es útil proporcionar una descripción adicional del enlace. Puedes hacerlo añadiendo un título opcional entre comillas después de la URL.

[www.luisllamas.es](https://www.luisllamas.es "Guía Completa de Markdown")

Esto se renderiza como:

Cuando el lector pasa el ratón sobre el enlace, verá el texto descriptivo proporcionado.

Enlaces internos

Los enlaces internos son útiles para navegar entre diferentes secciones dentro del mismo documento.

Markdown no soporta de manera nativa los enlaces internos en todos los motores, pero es posible hacerlo en muchos entornos, especialmente en plataformas como GitHub y GitLab.

Para crear un enlace interno, se utiliza la siguiente sintaxis:

[Texto del Enlace](URL-del-enlace/#nombre-del-ancla)

Donde #nombre-del-ancla corresponde al identificador de la sección a la que deseas enlazar. Este identificador se basa en el texto del encabezado al que estás enlazando, convertido en minúsculas y con los espacios reemplazados por guiones.

Por ejemplo

[Enlaces internos](/como-usar-enlaces-en-markdown/#enlaces-internos)

Esto se renderiza como:

Si haces click sobre el, te llevará a esta misma página, al principio de la sección “Enlaces internos”.

Finalmente, también podemos subrayar o destacar una fragmento de texto. Para eso, debemos indicar el principio y el final de las texto que queremos destacar, por ejemplo así

[Enlace interno con resaltado](/#enlaces-internos:~:text=Los%20enlaces%20internos,Github%20y%20Gitlab)

Que renderiza como:

Si lo pulsas, te llevará al principio de la sección “Enlaces internos”, con el primer párrafo seleccionado.

Buenas prácticas Consejos

Claridad en el texto del enlace: Usa un texto claro y descriptivo para que el lector entienda el propósito del enlace antes de hacer clic.

Personalmente, no uso la parte del tooltip flotante, porque da problemas en algunas plataformas. Pero el texto si

Enlaces externos: Los enlaces externos pueden dejar de funcionar, porque no dependen de ti. Asegúrate de que los enlaces externos sean relevantes y proporcionen valor adicional al contenido. Si no, no los agregues.