連結

如要建立內嵌連結,請在連結文字右方括號後方加入一組一般括號。在括號內輸入你希望連結指向的網址,以及選填的連結標題,並用引號括住。例如:

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.

在 Markdown 中指定 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.

接著,在文件中的任何位置,單獨一行定義連結標籤,如下所示:

連結網址可選擇用角括號圍住:

您可以在下一行中加入名稱屬性,並使用多餘的空格或 Tab 鍵做為邊框間距,這樣看起來較適合使用較長的網址:

連結定義名稱可能包含字母、數字、空格和標點符號,但不區分大小寫。例如:這兩個連結:

[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 支援建立「自動」功能的快速指令樣式網址和電子郵件地址的連結:只要以角括號括住網址或電子郵件地址即可。也就是說,如果想顯示網址或電子郵件地址的實際文字,而且擁有可點擊的連結,就可以執行以下操作:

<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」的可點擊連結。