# Markdown 文件
==================

**NOTE:** This is Traditional Chinese Edition Document of
Markdown Syntax. If you are seeking for English Edition
Document. Please refer to [Markdown: Syntax][eng-doc].
[eng-doc]:http://daringfireball.net/projects/markdown/syntax
Markdown: Syntax
================
* ? [概述](#overview)
? ?* ? [哲學(xué)](#philosophy)
? ?* ? [行內(nèi) HTML](#html)
? ?* ? [特殊字元自動(dòng)轉(zhuǎn)換](#autoescape)
* ? [區(qū)塊元素](#block)
? ?* ? [段落和換行](#p)
? ?* ? [標(biāo)題](#header)
? ?* ? [區(qū)塊引言](#blockquote)
? ?* ? [清單](#list)
? ?* ? [程式碼區(qū)塊](#precode)
? ?* ? [分隔線](#hr)
* ? [區(qū)段元素](#span)
? ?* ? [連結(jié)](#link)
? ?* ? [強(qiáng)調(diào)](#em)
? ?* ? [程式碼](#code)
? ?* ? [圖片](#img)
* ? [其它](#misc)
? ?* ? [跳脫字元](#backslash)
? ?* ? [自動(dòng)連結(jié)](#autolink)
* ? [感謝](#acknowledgement)
**注意:**這份文件是用 Markdown 寫的,你可以[看看它的原始檔][src] 。
?[src]: https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md
* * *
<h2 id="overview">概述</h2>
<h3 id="philosophy">哲學(xué)</h3>
Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」。
不過最需要強(qiáng)調(diào)的便是它的可讀性。一份使用 Markdown 格式撰寫的文件應(yīng)該可以直接以純文字發(fā)佈,並且看起來不會(huì)像是由許多標(biāo)籤或是格式指令所構(gòu)成。Markdown 語法受到一些既有 text-to-HTML 格式的影響,包括 [Setext] [1]、[atx] [2]、[Textile] [3]、[reStructuredText] [4]、[Grutatext] [5] 和 [EtText] [6],然而最大靈感來源其實(shí)是純文字的電子郵件格式。
?[1]: http://docutils.sourceforge.net/mirror/setext.html
?[2]: http://www.aaronsw.com/2002/atx/
?[3]: http://textism.com/tools/textile/
?[4]: http://docutils.sourceforge.net/rst.html
?[5]: http://www.triptico.com/software/grutatxt.html
?[6]: http://ettext.taint.org/doc/
因此 Markdown 的語法全由標(biāo)點(diǎn)符號(hào)所組成,並經(jīng)過嚴(yán)謹(jǐn)慎選,是為了讓它們看起來就像所要表達(dá)的意思。像是在文字兩旁加上星號(hào),看起來就像\*強(qiáng)調(diào)\*。Markdown 的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區(qū)塊引言看起來就真的像是引用一段文字。
<h3 id="html">行內(nèi) HTML</h3>
Markdown 的語法有個(gè)主要的目的:用來作為一種網(wǎng)路內(nèi)容的*寫作*用語言。
Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多,只和 HTML 的一部分有關(guān)係,重點(diǎn)*不是*要?jiǎng)?chuàng)造一種更容易寫作 HTML 文件的語法,我認(rèn)為 HTML 已經(jīng)很容易寫了,Markdown 的重點(diǎn)在於,它能讓文件更容易閱讀、編寫。HTML 是一種*發(fā)佈*的格式,Markdown 是一種*編寫*的格式,因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範(fàn)圍。
不在 Markdown 涵蓋範(fàn)圍之外的標(biāo)籤,都可以直接在文件裡面用 HTML 撰寫。不需要額外標(biāo)註這是 HTML 或是 Markdown;只要直接加標(biāo)籤就可以了。
只有區(qū)塊元素──比如 `<div>`、`<table>`、`<pre>`、`<p>` 等標(biāo)籤,必須在前後加上空行,以利與內(nèi)容區(qū)隔。而且這些(元素)的開始與結(jié)尾標(biāo)籤,不可以用 tab 或是空白來縮排。Markdown 的產(chǎn)生器有智慧型判斷,可以避免在區(qū)塊標(biāo)籤前後加上沒有必要的 `<p>` 標(biāo)籤。
舉例來說,在 Markdown 文件裡加上一段 HTML 表格:
? ?This is a regular paragraph.
? ?<table>
? ? ? ?<tr>
? ? ? ? ? ?<td>Foo</td>
? ? ? ?</tr>
? ?</table>
? ?This is another regular paragraph.
請注意,Markdown 語法在 HTML 區(qū)塊標(biāo)籤中將不會(huì)被進(jìn)行處理。例如,你無法在 HTML 區(qū)塊內(nèi)使用 Markdown 形式的`*強(qiáng)調(diào)*`。
HTML 的區(qū)段標(biāo)籤如 `<span>`、`<cite>`、`<del>` 則不受限制,可以在 Markdown 的段落、清單或是標(biāo)題裡任意使用。依照個(gè)人習(xí)慣,甚至可以不用Markdown 格式,而採用 HTML 標(biāo)籤來格式化。舉例說明:如果比較喜歡 HTML 的 ?`<a>` 或 `<img>` 標(biāo)籤,可以直接使用這些標(biāo)籤,而不用 Markdown 提供的連結(jié)或是影像標(biāo)示語法。
HTML 區(qū)段標(biāo)籤和區(qū)塊標(biāo)籤不同,在區(qū)段標(biāo)籤的範(fàn)圍內(nèi), Markdown 的語法是有效的。
<h3 id="autoescape">特殊字元自動(dòng)轉(zhuǎn)換</h3>
在 HTML 文件中,有兩個(gè)字元需要特殊處理: `<` 和 `&` 。 `<` 符號(hào)用於起始標(biāo)籤,`&` 符號(hào)則用於標(biāo)記 HTML 實(shí)體,如果你只是想要使用這些符號(hào),你必須要使用實(shí)體的形式,像是 `<` 和 `&`。
`&` 符號(hào)其實(shí)很容易讓寫作網(wǎng)路文件的人感到困擾,如果你要打「AT&T」 ,你必須要寫成「`AT&T`」 ,還得轉(zhuǎn)換網(wǎng)址內(nèi)的 `&` 符號(hào),如果你要連結(jié)到:
? ?http://images.google.com/images?num=30&q=larry+bird
你必須要把網(wǎng)址轉(zhuǎn)成:
? ?http://images.google.com/images?num=30&q=larry+bird
才能放到連結(jié)標(biāo)籤的 `href` 屬性裡。不用說也知道這很容易忘記,這也可能是 HTML 標(biāo)準(zhǔn)檢查所檢查到的錯(cuò)誤中,數(shù)量最多的。
Markdown 允許你直接使用這些符號(hào),但是你要小心跳脫字元的使用,如果你是在HTML 實(shí)體中使用 `&` 符號(hào)的話,它不會(huì)被轉(zhuǎn)換,而在其它情形下,它則會(huì)被轉(zhuǎn)換成 `&`。所以你如果要在文件中插入一個(gè)著作權(quán)的符號(hào),你可以這樣寫:
? ??
Markdown 將不會(huì)對這段文字做修改,但是如果你這樣寫:
? ?AT&T
Markdown 就會(huì)將它轉(zhuǎn)為:
? ?AT&T
類似的狀況也會(huì)發(fā)生在 `<` 符號(hào)上,因?yàn)?Markdown 支援 [行內(nèi) HTML](#html) ,如果你是使用 `<` 符號(hào)作為 HTML 標(biāo)籤使用,那 Markdown 也不會(huì)對它做任何轉(zhuǎn)換,但是如果你是寫:
? ?4 < 5
Markdown 將會(huì)把它轉(zhuǎn)換為:
? ?4 < 5
不過需要注意的是,code 範(fàn)圍內(nèi),不論是行內(nèi)還是區(qū)塊, `<` 和 `&` 兩個(gè)符號(hào)都*一定*會(huì)被轉(zhuǎn)換成 HTML 實(shí)體,這項(xiàng)特性讓你可以很容易地用 Markdown 寫 HTML code (和 HTML 相對而言, HTML 語法中,你要把所有的 `<` 和 `&` 都轉(zhuǎn)換為 HTML 實(shí)體,才能在 HTML 文件裡面寫出 HTML code。)
* * *
<h2 id="block">區(qū)塊元素</h2>
<h3 id="p">段落和換行</h3>
一個(gè)段落是由一個(gè)以上相連接的行句組成,而一個(gè)以上的空行則會(huì)切分出不同的段落(空行的定義是顯示上看起來像是空行,便會(huì)被視為空行。比方說,若某一行只包含空白和 tab,則該行也會(huì)被視為空行),一般的段落不需要用空白或斷行縮排。
「一個(gè)以上相連接的行句組成」這句話其實(shí)暗示了 Markdown 允許段落內(nèi)的強(qiáng)迫斷行,這個(gè)特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的「Convert Line Breaks」選項(xiàng)),其它的格式會(huì)把每個(gè)斷行都轉(zhuǎn)成 `<br />` 標(biāo)籤。
如果你*真的*想要插入 `<br />` 標(biāo)籤的話,在行尾加上兩個(gè)以上的空白,然後按 enter。
是的,這確實(shí)需要花比較多功夫來插入 `<br />` ,但是「每個(gè)換行都轉(zhuǎn)換為 `<br />`」的方法在 Markdown 中並不適合, Markdown 中 email 式的 [區(qū)塊引言][bq] 和多段落的 [清單][l] 在使用換行來排版的時(shí)候,不但更好用,還更好閱讀。
?[bq]: #blockquote
?[l]: ?#list
<h3 id="header">標(biāo)題</h3>
Markdown 支援兩種標(biāo)題的語法,[Setext] [1] 和 [atx] [2] 形式。
Setext 形式是用底線的形式,利用 `=` (最高階標(biāo)題)和 `-` (第二階標(biāo)題),例如:
? ?This is an H1
? ?=============
? ?This is an H2
? ?-------------
任何數(shù)量的 `=` 和 `-` 都可以有效果。
Atx 形式則是在行首插入 1 到 6 個(gè) `#` ,對應(yīng)到標(biāo)題 1 到 6 階,例如:
? ?# This is an H1
? ?## This is an H2
? ?###### This is an H6
你可以選擇性地「關(guān)閉」atx 樣式的標(biāo)題,這純粹只是美觀用的,若是覺得這樣看起來比較舒適,你就可以在行尾加上 `#`,而行尾的 `#` 數(shù)量也不用和開頭一樣(行首的井字?jǐn)?shù)量決定標(biāo)題的階數(shù)):
? ?# This is an H1 #
? ?## This is an H2 ##
? ?### This is an H3 ######
<h3 id="blockquote">Blockquotes</h3>
Markdown 使用 email 形式的區(qū)塊引言,如果你很熟悉如何在 email 信件中引言,你就知道怎麼在 Markdown 文件中建立一個(gè)區(qū)塊引言,那會(huì)看起來像是你強(qiáng)迫斷行,然後在每行的最前面加上 `>` :
? ?> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
? ?> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
? ?> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
? ?>
? ?> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
? ?> id sem consectetuer libero luctus adipiscing.
Markdown 也允許你只在整個(gè)段落的第一行最前面加上 `>` :
? ?> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
? ?consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
? ?Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
? ?> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
? ?id sem consectetuer libero luctus adipiscing.
區(qū)塊引言可以有階層(例如:引言內(nèi)的引言),只要根據(jù)層數(shù)加上不同數(shù)量的 `>` :
? ?> This is the first level of quoting.
? ?>
? ?> > This is nested blockquote.
? ?>
? ?> Back to the first level.
引言的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法,包括標(biāo)題、清單、程式碼區(qū)塊等:
> ## This is a header.
>
> 1. ? This is the first list item.
> 2. ? This is the second list item.
>
> Here's some example code:
>
> ? ? return shell_exec("echo $input | $markdown_script");
任何標(biāo)準(zhǔn)的文字編輯器都能簡單地建立 email 樣式的引言,例如 BBEdit ,你可以選取文字後然後從選單中選擇*增加引言階層*。
<h3 id="list">清單</h3>
Markdown 支援有序清單和無序清單。
無序清單使用星號(hào)、加號(hào)或是減號(hào)作為清單標(biāo)記:
? ?* ? Red
? ?* ? Green
? ?* ? Blue
等同於:
? ?+ ? Red
? ?+ ? Green
? ?+ ? Blue
也等同於:
? ?- ? Red
? ?- ? Green
? ?- ? Blue
有序清單則使用數(shù)字接著一個(gè)英文句點(diǎn):
? ?1. ?Bird
? ?2. ?McHale
? ?3. ?Parish
很重要的一點(diǎn)是,你在清單標(biāo)記上使用的數(shù)字並不會(huì)影響輸出的 HTML 結(jié)果,上面的清單所產(chǎn)生的 HTML 標(biāo)記為:
? ?<ol>
? ?<li>Bird</li>
? ?<li>McHale</li>
? ?<li>Parish</li>
? ?</ol>
如果你的清單標(biāo)記寫成:
? ?1. ?Bird
? ?1. ?McHale
? ?1. ?Parish
或甚至是:
? ?3. Bird
? ?1. McHale
? ?8. Parish
你都會(huì)得到完全相同的 HTML 輸出。重點(diǎn)在於,你可以讓 Markdown 文件的清單數(shù)字和輸出的結(jié)果相同,或是你懶一點(diǎn),你可以完全不用在意數(shù)字的正確性。
如果你使用懶惰的寫法,建議第一個(gè)項(xiàng)目最好還是從 1. 開始,因?yàn)?Markdown 未來可能會(huì)支援有序清單的 start 屬性。
清單項(xiàng)目標(biāo)記通常是放在最左邊,但是其實(shí)也可以縮排,最多三個(gè)空白,項(xiàng)目標(biāo)記後面則一定要接著至少一個(gè)空白或 tab。
要讓清單看起來更漂亮,你可以把內(nèi)容用固定的縮排整理好:
? ?* ? Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
? ? ? ?Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
? ? ? ?viverra nec, fringilla in, laoreet vitae, risus.
? ?* ? Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
? ? ? ?Suspendisse id sem consectetuer libero luctus adipiscing.
但是如果你很懶,那也不一定需要:
? ?* ? Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
? ?Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
? ?viverra nec, fringilla in, laoreet vitae, risus.
? ?* ? Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
? ?Suspendisse id sem consectetuer libero luctus adipiscing.
如果清單項(xiàng)目間用空行分開, Markdown 會(huì)把項(xiàng)目的內(nèi)容在輸出時(shí)用 `<p>`
標(biāo)籤包起來,舉例來說:
? ?* ? Bird
? ?* ? Magic
會(huì)被轉(zhuǎn)換為:
? ?<ul>
? ?<li>Bird</li>
? ?<li>Magic</li>
? ?</ul>
但是這個(gè):
? ?* ? Bird
? ?* ? Magic
會(huì)被轉(zhuǎn)換為:
? ?<ul>
? ?<li><p>Bird</p></li>
? ?<li><p>Magic</p></li>
? ?</ul>
清單項(xiàng)目可以包含多個(gè)段落,每個(gè)項(xiàng)目下的段落都必須縮排 4 個(gè)空白或是一個(gè) tab :
? ?1. ?This is a list item with two paragraphs. Lorem ipsum dolor
? ? ? ?sit amet, consectetuer adipiscing elit. Aliquam hendrerit
? ? ? ?mi posuere lectus.
? ? ? ?Vestibulum enim wisi, viverra nec, fringilla in, laoreet
? ? ? ?vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
? ? ? ?sit amet velit.
? ?2. ?Suspendisse id sem consectetuer libero luctus adipiscing.
如果你每行都有縮排,看起來會(huì)看好很多,當(dāng)然,再次地,如果你很懶惰,Markdown 也允許:
? ?* ? This is a list item with two paragraphs.
? ? ? ?This is the second paragraph in the list item. You're
? ?only required to indent the first line. Lorem ipsum dolor
? ?sit amet, consectetuer adipiscing elit.
? ?* ? Another item in the same list.
如果要在清單項(xiàng)目內(nèi)放進(jìn)引言,那 `>` 就需要縮排:
? ?* ? A list item with a blockquote:
? ? ? ?> This is a blockquote
? ? ? ?> inside a list item.
如果要放程式碼區(qū)塊的話,該區(qū)塊就需要縮排*兩次*,也就是 8 個(gè)空白或是兩個(gè) tab:
? ?* ? A list item with a code block:
? ? ? ? ? ?<code goes here>
當(dāng)然,項(xiàng)目清單很可能會(huì)不小心產(chǎn)生,像是下面這樣的寫法:
? ?1986. What a great season.
換句話說,也就是在行首出現(xiàn)*數(shù)字-句點(diǎn)-空白*,要避免這樣的狀況,你可以在句點(diǎn)前面加上反斜線。
? ?1986\. What a great season.
<h3 id="precode">程式碼區(qū)塊</h3>
和程式相關(guān)的寫作或是標(biāo)籤語言原始碼通常會(huì)有已經(jīng)排版好的程式碼區(qū)塊,通常這些區(qū)塊我們並不希望它以一般段落文件的方式去排版,而是照原來的樣子顯示,Markdown 會(huì)用 `<pre>` 和 `<code>` 標(biāo)籤來把程式碼區(qū)塊包起來。
要在 Markdown 中建立程式碼區(qū)塊很簡單,只要簡單地縮排 4 個(gè)空白或是 1 個(gè) tab 就可以,例如,下面的輸入:
? ?This is a normal paragraph:
? ? ? ?This is a code block.
Markdown 會(huì)轉(zhuǎn)換成:
? ?<p>This is a normal paragraph:</p>
? ?<pre><code>This is a code block.
? ?</code></pre>
這個(gè)每行一階的縮排(4 個(gè)空白或是 1 個(gè) tab),都會(huì)被移除,例如:
? ?Here is an example of AppleScript:
? ? ? ?tell application "Foo"
? ? ? ? ? ?beep
? ? ? ?end tell
會(huì)被轉(zhuǎn)換為:
? ?<p>Here is an example of AppleScript:</p>
? ?<pre><code>tell application "Foo"
? ? ? ?beep
? ?end tell
? ?</code></pre>
一個(gè)程式碼區(qū)塊會(huì)一直持續(xù)到?jīng)]有縮排的那一行(或是文件結(jié)尾)。
在程式碼區(qū)塊裡面, `&` 、 `<` 和 `>` 會(huì)自動(dòng)轉(zhuǎn)成 HTML 實(shí)體,這樣的方式讓你非常容易使用 Markdown 插入範(fàn)例用的 HTML 原始碼,只需要複製貼上,再加上縮排就可以了,剩下的 Markdown 都會(huì)幫你處理,例如:
? ? ? ?<div class="footer">
? ? ? ? ? ?? 2004 Foo Corporation
? ? ? ?</div>
會(huì)被轉(zhuǎn)換為:
? ?<pre><code><div class="footer">
? ? ? ?© 2004 Foo Corporation
? ?</div>
? ?</code></pre>
程式碼區(qū)塊中,一般的 Markdown 語法不會(huì)被轉(zhuǎn)換,像是星號(hào)便只是星號(hào),這表示你可以很容易地以 Markdown 語法撰寫 Markdown 語法相關(guān)的文件。
<h3 id="hr">分隔線</h3>
你可以在一行中用三個(gè)或以上的星號(hào)、減號(hào)、底線來建立一個(gè)分隔線,行內(nèi)不能有其他東西。你也可以在星號(hào)中間插入空白。下面每種寫法都可以建立分隔線:
? ?* * *
? ?***
? ?*****
? ?- - -
? ?---------------------------------------
* * *
<h2 id="span">區(qū)段元素</h2>
<h3 id="link">連結(jié)</h3>
Markdown 支援兩種形式的連結(jié)語法: *行內(nèi)*和*參考*兩種形式。
不管是哪一種,連結(jié)的文字都是用 [方括號(hào)] 來標(biāo)記。
要建立一個(gè)行內(nèi)形式的連結(jié),只要在方塊括號(hào)後面馬上接著括號(hào)並插入網(wǎng)址連結(jié)即可,如果你還想要加上連結(jié)的 title 文字,只要在網(wǎng)址後面,用雙引號(hào)把 title 文字包起來即可,例如:
? ?This is [an example](http://example.com/ "Title") inline link.
? ?[This link](http://example.net/) has no title attribute.
會(huì)產(chǎn)生:
? ?<p>This is <a title="Title">
? ?an example</a> inline link.</p>
? ?<p><a >This link</a> has no
? ?title attribute.</p>
如果你是要連結(jié)到同樣主機(jī)的資源,你可以使用相對路徑:
? ?See my [About](/about/) page for details. ?
參考形式的連結(jié)使用另外一個(gè)方括號(hào)接在連結(jié)文字的括號(hào)後面,而在第二個(gè)方括號(hào)裡面要填入用以辨識(shí)連結(jié)的標(biāo)籤:
? ?This is [an example][id] reference-style link.
你也可以選擇性地在兩個(gè)方括號(hào)中間加上空白:
? ?This is [an example] [id] reference-style link.
接著,在文件的任意處,你可以把這個(gè)標(biāo)籤的連結(jié)內(nèi)容定義出來:
? ?[id]: http://example.com/ ?"Optional Title Here"
連結(jié)定義的形式為:
* ? 方括號(hào),裡面輸入連結(jié)的辨識(shí)用標(biāo)籤
* ? 接著一個(gè)冒號(hào)
* ? 接著一個(gè)以上的空白或 tab
* ? 接著連結(jié)的網(wǎng)址
* ? 選擇性地接著 title 內(nèi)容,可以用單引號(hào)、雙引號(hào)或是括弧包著
下面這三種連結(jié)的定義都是相同:
[foo]: http://example.com/ ?"Optional Title Here"
[foo]: http://example.com/ ?'Optional Title Here'
[foo]: http://example.com/ ?(Optional Title Here)
**請注意:**有一個(gè)已知的問題是 Markdown.pl 1.0.1 會(huì)忽略單引號(hào)包起來的連結(jié) title。
連結(jié)網(wǎng)址也可以用方括號(hào)包起來:
? ?[id]: <http://example.com/> ?"Optional Title Here"
你也可以把 title 屬性放到下一行,也可以加一些縮排,網(wǎng)址太長的話,這樣會(huì)比較好看:
? ?[id]: http://example.com/longish/path/to/resource/here
? ? ? ?"Optional Title Here"
網(wǎng)址定義只有在產(chǎn)生連結(jié)的時(shí)候用到,並不會(huì)直接出現(xiàn)在文件之中。
連結(jié)辨識(shí)標(biāo)籤可以有字母、數(shù)字、空白和標(biāo)點(diǎn)符號(hào),但是並*不*區(qū)分大小寫,因此下面兩個(gè)連結(jié)是一樣的:
[link text][a]
[link text][A]
*預(yù)設(shè)的連結(jié)標(biāo)籤*功能讓你可以省略指定連結(jié)標(biāo)籤,這種情形下,連結(jié)標(biāo)籤和連結(jié)文字會(huì)視為相同,要用預(yù)設(shè)連結(jié)標(biāo)籤只要在連結(jié)文字後面加上一個(gè)空的方括號(hào),如果你要讓 "Google" 連結(jié)到 google.com,你可以簡化成:
[Google][]
然後定義連結(jié)內(nèi)容:
[Google]: http://google.com/
由於連結(jié)文字可能包含空白,所以這種簡化的標(biāo)籤內(nèi)也可以包含多個(gè)文字:
Visit [Daring Fireball][] for more information.
然後接著定義連結(jié):
[Daring Fireball]: http://daringfireball.net/
連結(jié)的定義可以放在文件中的任何一個(gè)地方,我比較偏好直接放在連結(jié)出現(xiàn)段落的後面,你也可以把它放在文件最後面,就像是註解一樣。
下面是一個(gè)參考式連結(jié)的範(fàn)例:
? ?I get 10 times more traffic from [Google] [1] than from
? ?[Yahoo] [2] or [MSN] [3].
? ? ?[1]: http://google.com/ ? ? ? ?"Google"
? ? ?[2]: http://search.yahoo.com/ ?"Yahoo Search"
? ? ?[3]: http://search.msn.com/ ? ?"MSN