Legături

Pentru a crea o legătură inline, utilizați un set de paranteze obișnuite imediat după paranteza pătrată de închidere a textului linkului. În paranteze, puneți adresa URL unde doriți să indice linkul, împreună cu un titlu opțional pentru link, între ghilimele. De exemplu:

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

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

Va produce:

<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>

Dacă vă referiți la o resursă locală de pe același server, puteți utiliza căi relative:

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

Specificarea atributelor HTML în markdown

Pentru a adăuga unul sau mai multe atribute la un link de reducere, puteți utiliza următorul format delimitat de spațiu:

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

Puteți avertiza cititorii că un link va duce la un site extern adăugând {: .external} la sintaxă.

Legăturile în stil de referință folosesc un al doilea set de paranteze pătrate, în interiorul cărora plasați o etichetă pe care o alegeți pentru a identifica legătura:

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

Opțional, puteți utiliza un spațiu pentru a separa seturile de paranteze:

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

Apoi, oriunde în document, vă definiți eticheta linkului astfel, pe o singură linie:

URL-ul linkului poate fi, opțional, înconjurat de paranteze unghiulare:

Puteți pune atributul titlu pe rândul următor și puteți utiliza spații sau file suplimentare pentru umplutură, care tinde să arate mai bine cu adrese URL mai lungi:

Numele definițiilor linkurilor pot consta din litere, cifre, spații și semne de punctuație, dar nu țin cont de majuscule și minuscule. De exemplu, aceste două link-uri:

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

sunt echivalente.

Comanda implicită pentru numele link-ului vă permite să omiteți numele link-ului, caz în care textul link-ului însuși este folosit ca nume. Utilizați doar un set de paranteze drepte -- de exemplu, pentru a lega cuvântul „Google” la site-ul web google.com, puteți scrie pur și simplu:

[Google]

Și apoi definiți linkul:

Deoarece numele linkurilor pot conține spații, această comandă rapidă funcționează chiar și pentru mai multe cuvinte din textul linkului:

Visit [Daring Fireball] for more information.

Și apoi definiți linkul:

Definițiile linkurilor pot fi plasate oriunde în documentul Markdown. Tind să le pun imediat după fiecare paragraf în care sunt folosite, dar dacă doriți, le puteți pune pe toate la sfârșitul documentului, ca niște note de subsol.

Iată un exemplu de linkuri de referință în acțiune: 

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

Folosind scurtătura implicită pentru numele link-ului, ați putea scrie: 

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

Ambele exemple de mai sus vor produce următoarea ieșire 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>

Pentru comparație, iată același paragraf scris folosind stilul de link inline al lui 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 acceptă un stil de scurtătură pentru crearea de link-uri „automate” pentru adrese URL și adrese de e-mail: pur și simplu înconjurați adresa URL sau adresa de e-mail cu paranteze unghiulare. Acest lucru înseamnă că, dacă doriți să afișați textul real al unei adrese URL sau a unei adrese de e-mail și, de asemenea, să fie un link pe care se poate face clic, puteți face acest lucru: 

<http://example.com/>

Markdown va transforma acest lucru în: 

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

Linkurile automate pentru adresele de e-mail funcționează în mod similar, cu excepția faptului că Markdown va efectua, de asemenea, un pic de codificare aleatorie a entităților zecimale și hexadecimale pentru a ajuta la ascunderea adresei dvs. de spamboții care colectează adrese. De exemplu, Markdown va transforma acest lucru: 

<address@example.com>

in ceva de genul asta: 

<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>

care se va afișa într-un browser ca link pe care se poate face clic către „address@example.com”.