Odkazy

Chcete-li vytvořit vložený odkaz, použijte sadu pravidelných závorek bezprostředně za hranatou závorkou textu odkazu. Do závorek vložte adresu URL, kam chcete, aby odkaz směřoval, spolu s volitelným názvem odkazu v uvozovkách. Například:

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

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

Vyrobí:

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

Pokud odkazujete na místní zdroj na stejném serveru, můžete použít relativní cesty:

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

Určení atributů HTML v markdown

Chcete-li k odkazu markdown přidat jeden nebo více atributů, můžete použít následující formát oddělený mezerou:

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

Můžete čtenáře upozornit, že odkaz povede na externí web přidáním {: .external} do syntaxe.

Odkazy ve stylu odkazu používají druhou sadu hranatých závorek, do kterých umístíte štítek dle vlastního výběru k identifikaci odkazu:

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

Volitelně můžete použít mezeru k oddělení sad závorek:

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

Poté kdekoli v dokumentu definujete svůj štítek odkazu takto, na samostatném řádku:

Adresa URL odkazu může být volitelně ohraničena lomenými závorkami:

Atribut title můžete umístit na další řádek a použít další mezery nebo tabulátory pro odsazení, což má tendenci vypadat lépe s delšími adresami URL:

Názvy definic odkazů se mohou skládat z písmen, číslic, mezer a interpunkce – nerozlišují však velká a malá písmena. Například tyto dva odkazy:

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

jsou ekvivalentní.

Zkratka implicitního názvu odkazu umožňuje vynechat název odkazu, v takovém případě se jako název použije samotný text odkazu. Stačí použít sadu hranatých závorek – např. pro spojení slova „Google“ s webovou stránkou google.com můžete jednoduše napsat:

[Google]

A pak definujte odkaz:

Protože názvy odkazů mohou obsahovat mezery, tato zkratka funguje i pro více slov v textu odkazu:

Visit [Daring Fireball] for more information.

A pak definujte odkaz:

Definice odkazů lze umístit kamkoli do dokumentu Markdown. Mám tendenci je dávat hned za každý odstavec, ve kterém jsou použity, ale pokud chcete, můžete je všechny umístit na konec dokumentu, něco jako poznámky pod čarou.

Zde je příklad referenčních odkazů v akci: 

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

Pomocí zkratky názvu implicitního odkazu můžete místo toho napsat: 

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

Oba výše uvedené příklady vytvoří následující HTML výstup: 

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

Pro srovnání je zde stejný odstavec napsaný pomocí stylu vloženého odkazu 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 podporuje styl zkratek pro vytváření „automatických“ odkazů pro URL a e-mailové adresy: jednoduše obklopte URL nebo e-mailovou adresu lomenými závorkami. To znamená, že pokud chcete zobrazit skutečný text adresy URL nebo e-mailové adresy a také mít odkaz, na který lze kliknout, můžete to udělat takto: 

<http://example.com/>

Markdown to změní na: 

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

Automatické odkazy na e-mailové adresy fungují podobně, až na to, že Markdown také provede trochu náhodného desítkového a hexadecimálního kódování entit, aby pomohl skrýt vaši adresu před spamboty sbírajícími adresy. Například Markdown změní toto: 

<address@example.com>

do něčeho takového: 

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

který se v prohlížeči vykreslí jako klikací odkaz na adresu „adresa@example.com“.