Enlaces en Markdown: en línea, de referencia y anclas
Las cuatro formas de crear enlaces en Markdown: en línea con corchetes, de referencia, automáticos y anclas internas. Incluye títulos emergentes, enlaces relativos y cómo abrir en pestaña nueva.
Enlazar es probablemente lo segundo que más se hace en Markdown después de dar formato al texto. Hay cuatro sintaxis distintas y cada una tiene su momento.
Enlaces en línea
Los de toda la vida: el texto entre corchetes y la URL entre paréntesis, sin espacio entre el cierre del corchete y la apertura del paréntesis.
Aprende más en [Markdown.es](https://markdown.es).Aprende más en Markdown.es.
Es la forma que usarás el 90 % de las veces. Directa y legible mientras la URL sea corta.
Con título emergente
Puedes añadir un título entre comillas después de la URL. Aparece como tooltip al dejar el cursor encima y se traduce al atributo title del HTML.
[Markdown.es](https://markdown.es "Guía de Markdown en español")Es opcional y poca gente lo usa, pero mejora la accesibilidad cuando el texto del enlace es genérico.
URLs con espacios o paréntesis
Si la URL contiene espacios, envuélvela entre < y >:
[Un documento](<https://ejemplo.com/mi archivo.pdf>)Si contiene paréntesis —típico en Wikipedia—, escapa los internos con barra invertida o usa la forma anterior:
[Markdown (lenguaje)](https://es.wikipedia.org/wiki/Markdown_\(lenguaje\))Enlaces de referencia
Cuando el texto tiene muchos enlaces, o URLs muy largas, meterlas en línea destroza la legibilidad del original. La solución son los enlaces de referencia: enlazas con una etiqueta corta y defines la URL en otro lugar del documento.
Me llamo Javier y escribo sobre [viajes a Grecia][web].
Ese [proyecto][web] nació porque me encanta el país.
[web]: https://helenizarte.com "Turismo en Grecia"Me llamo Javier y escribo sobre viajes a Grecia.
Ese proyecto nació porque me encanta el país.
Las definiciones no aparecen en el resultado final: desaparecen al procesarse. Puedes colocarlas donde quieras —al final del documento es lo habitual— y reutilizar la misma etiqueta tantas veces como necesites.
Etiqueta implícita
Si el texto del enlace ya coincide con la etiqueta, puedes dejar los segundos corchetes vacíos:
Consulta la [documentación][] para más detalles.
[documentación]: https://markdown.es/sintaxis-markdownConsulta la documentación para más detalles.
Las etiquetas no distinguen mayúsculas ([Web] y [web] son la misma) y pueden contener espacios.
Cuándo usar cada forma
| Situación | Mejor opción |
|---|---|
| Uno o dos enlaces cortos | En línea |
| Misma URL repetida varias veces | De referencia |
| URLs largas con parámetros de seguimiento | De referencia |
| Documentación que se revisa a menudo | De referencia |
| Comentario rápido en un issue | En línea |
Enlaces automáticos
Si quieres mostrar la URL completa como texto visible, envuélvela entre < y >:
<https://markdown.es>
<hola@ejemplo.com>Funciona también con correos electrónicos, y algunos procesadores ofuscan la dirección para dificultar el trabajo a los recolectores de spam.
⚠️ Sin los símbolos <> no hay garantía. GitHub y muchos procesadores detectan las URLs sueltas y las enlazan solos, pero eso es una extensión, no parte del estándar. Si escribes https://markdown.es a pelo, en algunos sitios se quedará como texto plano.
Anclas: enlazar a una sección
Para enlazar a un punto concreto de la misma página se usa una almohadilla seguida del identificador del encabezado:
Salta a la sección de [tablas](#tablas).Los identificadores se generan automáticamente a partir del texto del encabezado: minúsculas, espacios convertidos en guiones y puntuación eliminada. Tienes el detalle en encabezados.
También puedes apuntar a una sección de otra página combinando ruta y ancla:
[Alineación de columnas](/sintaxis-markdown/tablas#alineación-de-columnas)Enlaces relativos
Dentro de un mismo sitio o repositorio, conviene enlazar en relativo en lugar de repetir el dominio:
[La guía de sintaxis](/sintaxis-markdown)
[Un archivo vecino](./otro-documento.md)
[Subir un nivel](../README.md)En GitHub los enlaces relativos entre archivos .md funcionan y son la forma recomendada de enlazar dentro de un repositorio: siguen funcionando aunque el repo se renombre o se clone.
Imágenes enlazadas
Combinando la sintaxis de imágenes con la de enlaces consigues una imagen clicable. La imagen va dentro de los corchetes del enlace:
[](https://markdown.es)Es el patrón habitual de las insignias de estado en los README de GitHub.
Lo que Markdown no puede hacer
Abrir en una pestaña nueva. No existe sintaxis para target="_blank". Si lo necesitas, escribe el enlace en HTML:
<a href="https://markdown.es" target="_blank" rel="noopener">Markdown.es</a>Controlar rel="nofollow" o sponsored. Mismo caso: solo con HTML. Es relevante si publicas enlaces de afiliado o patrocinados, donde marcarlos correctamente es obligatorio según las directrices de Google.
Dar estilo al enlace. El color y el subrayado los decide el CSS de la plataforma, no Markdown.
Errores frecuentes
Espacio entre corchete y paréntesis. [texto] (url) no funciona. Deben ir pegados.
Invertir el orden. Es [texto](url), no (texto)[url]. Es el error más común de quien viene de otros lenguajes de marcado.
Corchetes sin cerrar dentro del texto. Si el texto del enlace contiene corchetes, escápalos: [Ver \[nota 1\]](/notas).
Definición de referencia con línea en blanco. La definición [web]: https://... debe estar en su propia línea, sin sangría de más de tres espacios (cuatro la convertirían en bloque de código).
Pruébalo
Verifica que tus enlaces se procesan bien en el previsualizador de Markdown. Y si estás pasando contenido desde una web, el conversor de HTML a Markdown convierte automáticamente todas las etiquetas <a> a sintaxis Markdown.