Посилання

Щоб створити вбудоване посилання, використовуйте набір звичайних дужок відразу після квадратної дужки, що закриває текст посилання. У дужках помістіть 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».