Nuorodos

Norėdami sukurti įterptą nuorodą, naudokite įprastų skliaustų rinkinį iškart po nuorodos teksto baigiamojo laužtinio skliausto. Skliausteliuose pateikite URL, kur norite, kad nuoroda būtų nukreipta, kartu su pasirenkamu nuorodos pavadinimu, kabutėse. Pavyzdžiui:

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

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

Gamins:

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

Jei nurodote vietinį šaltinį tame pačiame serveryje, galite naudoti santykinius kelius:

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

Nurodykite HTML atributus žymėjime

Norėdami pridėti vieną ar daugiau atributų prie žymėjimo nuorodos, galite naudoti šį tarpais atskirtą formatą:

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

Galite įspėti skaitytojus, kad nuoroda nuves į išorinę svetainę, prie sintaksės pridėdami {: .external} .

Nuorodų stiliaus nuorodose naudojamas antrasis laužtinių skliaustų rinkinys, kurio viduje įdedate pasirinktą etiketę, kad identifikuotumėte nuorodą:

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

Jei norite atskirti skliaustų rinkinius, pasirinktinai galite naudoti tarpą:

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

Tada bet kurioje dokumento vietoje savo nuorodos etiketę apibrėžiate taip, pačioje eilutėje:

Nuorodos URL, pasirinktinai, gali būti apsuptas kampiniais skliaustais:

Kitoje eilutėje galite įdėti pavadinimo atributą ir užpildyti papildomus tarpus arba skirtukus, kurie paprastai atrodo geriau naudojant ilgesnius URL:

Nuorodų apibrėžimų pavadinimus gali sudaryti raidės, skaičiai, tarpai ir skyrybos ženklai, tačiau juose neskiriamos didžiosios ir mažosios raidės. Pavyzdžiui, šios dvi nuorodos:

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

yra lygiaverčiai.

Netiesioginis nuorodos pavadinimo spartusis klavišas leidžia praleisti nuorodos pavadinimą, tokiu atveju pats nuorodos tekstas naudojamas kaip pavadinimas. Tiesiog naudokite laužtinius skliaustus – pvz., norėdami susieti žodį „Google“ su svetaine google.com, galite tiesiog parašyti:

[Google]

Ir tada apibrėžkite nuorodą:

Kadangi nuorodų pavadinimuose gali būti tarpų, šis spartusis klavišas veikia net keliems nuorodos teksto žodžiams:

Visit [Daring Fireball] for more information.

Ir tada apibrėžkite nuorodą:

Nuorodų apibrėžimus galima įdėti bet kurioje jūsų Markdown dokumento vietoje. Aš linkęs juos dėti iškart po kiekvienos pastraipos, kurioje jie naudojami, bet jei norite, galite juos visus įdėti dokumento pabaigoje, panašiai kaip išnašas.

Štai veikiančių nuorodų pavyzdys: 

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

Naudodami numanomą nuorodos pavadinimo spartųjį klavišą, galite parašyti: 

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

Abu aukščiau pateikti pavyzdžiai sukurs tokią HTML išvestį: 

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

Palyginimui, čia yra ta pati pastraipa, parašyta naudojant „Markdown“ tiesioginės nuorodos stilių: 

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“ palaiko nuorodų stilių, skirtą „automatinėms“ URL ir el. pašto adresų nuorodoms kurti: tiesiog apveskite URL arba el. pašto adresą kampiniais skliaustais. Tai reiškia, kad jei norite rodyti tikrąjį URL arba el. pašto adreso tekstą, taip pat turėti nuorodą, kurią galima spustelėti, galite tai padaryti: 

<http://example.com/>

Markdown tai pavers: 

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

Automatinės el. pašto adresų nuorodos veikia panašiai, išskyrus tai, kad Markdown taip pat atliks šiek tiek atsitiktinės atrankos dešimtainių ir šešioliktainių objektų kodavimo, kad padėtų paslėpti jūsų adresą nuo adresus renkančių šiukšlių. Pavyzdžiui, Markdown pavers tai: 

<address@example.com>

į kažką panašaus: 

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

kuri naršyklėje bus pateikta kaip spustelėjama nuoroda į „adresas@example.com“.