Enllaços

Per crear un enllaç en línia, utilitzeu un conjunt de parèntesis regulars immediatament després del claudàtor de tancament del text de l'enllaç. Dins dels parèntesis, poseu l'URL on voleu que apunti l'enllaç, juntament amb un títol opcional per a l'enllaç, envoltat entre cometes. Per exemple:

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

Produirà:

<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>

<p><a href="http://example.net/">This link</a> has no
title attribute.</p>

Si us referiu a un recurs local al mateix servidor, podeu utilitzar camins relatius:

See my [About](/about/) page for details.

Especificació d'atributs HTML a Markdown

Per afegir un o més atributs a un enllaç de reducció, podeu utilitzar el següent format delimitat per espais:

[link text](url){: attribute="value" attribute2="value2" attribute3="value3"}

Podeu avisar els lectors que un enllaç conduirà a un lloc extern afegint {: .external} a la sintaxi.

Els enllaços d'estil de referència utilitzen un segon conjunt de claudàtors, dins dels quals col·loqueu una etiqueta que trieu per identificar l'enllaç:

This is [an example][id] reference-style link.

Opcionalment, podeu utilitzar un espai per separar els conjunts de claudàtors:

This is [an example] [id] reference-style link.

A continuació, a qualsevol part del document, definiu l'etiqueta de l'enllaç així, en una línia per si sola:

L'URL de l'enllaç pot, opcionalment, estar envoltat per claudàtors angulars:

Podeu posar l'atribut title a la línia següent i fer servir espais o pestanyes addicionals per al farciment, que acostuma a semblar millor amb URL més llargs:

Els noms de definició d'enllaç poden consistir en lletres, números, espais i signes de puntuació, però no distingeixen entre majúscules i minúscules. Per exemple, aquests dos enllaços:

[link text][a]
[link text][A]

són equivalents.

La drecera implícita del nom de l'enllaç us permet ometre el nom de l'enllaç, en aquest cas el text de l'enllaç s'utilitza com a nom. Només cal que utilitzeu un conjunt de claudàtors; per exemple, per enllaçar la paraula "Google" al lloc web google.com, simplement podeu escriure:

[Google]

I després definiu l'enllaç:

Com que els noms dels enllaços poden contenir espais, aquesta drecera fins i tot funciona per a diverses paraules del text de l'enllaç:

Visit [Daring Fireball] for more information.

I després definiu l'enllaç:

Les definicions d'enllaç es poden col·locar a qualsevol lloc del document Markdown. Acostumo a posar-los immediatament després de cada paràgraf en què s'utilitzen, però si voleu, podeu posar-los tots al final del vostre document, com a notes a peu de pàgina.

Aquí teniu un exemple d'enllaços de referència en acció: 

I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].

Utilitzant la drecera implícita del nom de l'enllaç, podeu escriure: 

I get 10 times more traffic from [Google] than from
[Yahoo] or [MSN].

Els dos exemples anteriors produiran la següent sortida HTML: 

<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>

Per comparar, aquí teniu el mateix paràgraf escrit amb l'estil d'enllaç en línia de Markdown: 

I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").

Markdown admet un estil de drecera per crear enllaços "automàtics" per a URL i adreces de correu electrònic: simplement envolta l'URL o l'adreça de correu electrònic amb claudàtors angulars. Això vol dir que si voleu mostrar el text real d'una URL o una adreça de correu electrònic, i també que sigui un enllaç en què es pot fer clic, podeu fer això: 

<http://example.com/>

Markdown convertirà això en: 

<a href="http://example.com/">http://example.com/</a>

Els enllaços automàtics per a adreces de correu electrònic funcionen de la mateixa manera, excepte que Markdown també realitzarà una mica de codificació d'entitats hexadecimals i decimals aleatòries per ajudar a ocultar la vostra adreça dels robots de correu brossa que recullen adreces. Per exemple, Markdown convertirà això: 

<address@example.com>

en alguna cosa com això: 

<a href="&#x6D;&#x61;i&#x6C;&#x74;&#x6F;:&#x61;&#x64;&#x64;&#x72;&#x65;
&#115;&#115;&#64;&#101;&#120;&#x61;&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;
&#109;">&#x61;&#x64;&#x64;&#x72;&#x65;&#115;&#115;&#64;&#101;&#120;&#x61;
&#109;&#x70;&#x6C;e&#x2E;&#99;&#111;&#109;</a>

que es mostrarà en un navegador com un enllaç clicable a "address@example.com".