Връзки

За да създадете вградена връзка, използвайте набор от обикновени скоби непосредствено след затварящата квадратна скоба на текста на връзката. Вътре в скобите поставете URL адреса, където искате да сочи връзката, заедно с незадължително заглавие за връзката, оградено в кавички. Например:

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

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

Ще произвежда:

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

Ако препращате към локален ресурс на същия сървър, можете да използвате относителни пътища:

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

Указване на HTML атрибути в markdown

За да добавите един или повече атрибути към връзка за маркиране, можете да използвате следния формат, разделен с интервал:

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

Можете да предупредите читателите, че връзката ще доведе до външен сайт, като добавите {: .external} към синтаксиса.

Връзките в стил препратка използват втори набор от квадратни скоби, вътре в които поставяте етикет по ваш избор, за да идентифицирате връзката:

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

По желание можете да използвате интервал, за да разделите групите от скоби:

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

След това, където и да е в документа, дефинирате етикета на връзката си по този начин, на един ред:

URL адресът на връзката може, по избор, да бъде ограден с ъглови скоби:

Можете да поставите атрибута title на следващия ред и да използвате допълнителни интервали или табулатори за подпълване, което обикновено изглежда по-добре с по-дълги URL адреси:

Имената на дефинициите на връзките могат да се състоят от букви, цифри, интервали и препинателни знаци, но те не са чувствителни към главни и малки букви. Например тези две връзки:

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

са еквивалентни.

Прекият път за имплицитно име на връзката ви позволява да пропуснете името на връзката, като в този случай текстът на самата връзка се използва като име. Просто използвайте набор от квадратни скоби – например, за да свържете думата „Google“ към уеб сайта google.com, можете просто да напишете:

[Google]

И след това дефинирайте връзката:

Тъй като имената на връзките може да съдържат интервали, този пряк път работи дори за няколко думи в текста на връзката:

Visit [Daring Fireball] for more information.

И след това дефинирайте връзката:

Дефинициите на връзките могат да бъдат поставени навсякъде във вашия Markdown документ. Склонен съм да ги поставя веднага след всеки абзац, в който се използват, но ако искате, можете да ги поставите всички в края на вашия документ, нещо като бележки под линия.

Ето пример за референтни връзки в действие: 

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

Използвайки прекия път за имплицитно име на връзка, можете вместо това да напишете: 

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

И двата горни примера ще създадат следния 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>

За сравнение, ето същия абзац, написан с помощта на вградения стил на връзка на 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 поддържа стил за бърз достъп за създаване на „автоматични“ връзки за URL адреси и имейл адреси: просто заградете URL адреса или имейл адреса с ъглови скоби. Това означава, че ако искате да покажете действителния текст на URL или имейл адрес и също така да бъде връзка, върху която може да се кликне, можете да направите следното: 

<http://example.com/>

Markdown ще превърне това в: 

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

Автоматичните връзки за имейл адреси работят по подобен начин, с изключение на това, че Markdown също ще извърши малко рандомизирано десетично и шестнадесетично кодиране на обекти, за да ви помогне да скриете адреса си от спам ботове, събиращи адреси. Например Markdown ще превърне това: 

<address@example.com>

в нещо като това: 

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

който ще се визуализира в браузър като връзка с възможност за кликване към „address@example.com“.