內嵌連結
如要建立內嵌連結,請在連結文字右方括號後方加入一組一般括號。在括號內輸入你希望連結指向的網址,以及選填的連結標題,並用引號括住。例如:
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="mailto:addre
ss@example.co
m">address@exa
mple.com</a>
這會在瀏覽器中顯示為「address@example.com」的可點擊連結。