3. 區(qū)段元素

聲明:本文是對 Markdown 語法說明(簡體中文版)的轉(zhuǎn)載與臨摹。

鏈接

Markdown 支持兩種形式的鏈接語法: 行內(nèi)式參考式兩種形式。

不管是哪一種,鏈接文字都是用 [方括號] 來標(biāo)記。

要建立一個行內(nèi)式的鏈接接剩,只要在方塊括號后面緊接著圓括號并插入網(wǎng)址鏈接即可,如果你還想要加上鏈接的 title 文字萨咳,只要在網(wǎng)址后面懊缺,用雙引號把 title 文字包起來即可,例如:

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

會產(chǎn)生:

<p>This is <a  title="Title">
an example</a> inline link.</p>

<p><a >This link</a> has no
title attribute.</p>

如果你是要鏈接到同樣主機的資源培他,你可以使用相對路徑:

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

參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號鹃两,而在第二個方括號里面要填入用以辨識鏈接的標(biāo)記:

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

你也可以選擇性地在兩個方括號中間加上一個空格:

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

接著,在文件的任意處靶壮,你可以把這個標(biāo)記的鏈接內(nèi)容定義出來:

[id]: http://example.com/ "Optional Title Here"

鏈接內(nèi)容定義的形式為:

  • 方括號(前面可以選擇性地加上至多三個空格來縮進(jìn))怔毛,里面輸入鏈接文字
  • 接著一個冒號
  • 接著一個以上的空格或制表符
  • 接著鏈接的網(wǎng)址
  • 選擇性地接著 title 內(nèi)容员萍,可以用單引號腾降、雙引號或是括弧包著

下面這三種鏈接的定義都是相同的:

[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)

請注意:有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的鏈接 title。

鏈接網(wǎng)址也可以用尖括號包起來:

[id]: <http://example.com/> "Optional Title Here"

你也可以把 title 屬性放到下一行碎绎,也可以加一些縮進(jìn)螃壤,若網(wǎng)址太長的話,這樣會比較好看:

[id]: http://example.com/longish/path/to/resource/here 
    "Optional Title Here"

網(wǎng)址定義只有在產(chǎn)生鏈接的時候用到筋帖,并不會直接出現(xiàn)在文件之中奸晴。

鏈接辨別標(biāo)簽可以有字母、數(shù)字日麸、空白和標(biāo)點符號寄啼,但是并區(qū)分大小寫逮光,因此下面兩個鏈接是一樣的:

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

隱式鏈接標(biāo)記功能讓你可以省略指定鏈接標(biāo)記,這種情形下墩划,鏈接標(biāo)記會視為等同于鏈接文字涕刚,要用隱式鏈接標(biāo)記只要在鏈接文字后面加上一個空的方括號,如果你要讓 "Google" 鏈接到 google.com乙帮,你可以簡化成:

[Google][]

然后定義鏈接內(nèi)容:

[Google]: http://google.com/

由于鏈接文字可能包含空白杜漠,所以這種簡化型的標(biāo)記內(nèi)也許包含多個單詞:

Visit [Daring Fireball][] for more information.

然后接著定義鏈接:

[Daring Fireball]: http://daringfireball.net/

鏈接的定義可以放在文件中的任何一個地方,我比較偏好直接放在鏈接出現(xià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 Search"

如果改成用鏈接名稱的方式寫:

I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][]. 
[google]: http://google.com/ "Google" 
[yahoo]: http://search.yahoo.com/ "Yahoo Search" 
[msn]: http://search.msn.com/ "MSN Search"

上面兩種寫法都會產(chǎn)生下面的 HTML氢卡。

<p>I get 10 times more traffic from <a href="http://google.com/
"title="Google">Google</a> than from
<a  title="Yahoo Search">Yahoo</a>
or <a  title="MSN Search">MSN</a>.</p>

下面是用行內(nèi)式寫的同樣一段內(nèi)容的 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").

參考式的鏈接其實重點不在于它比較好寫,而是它比較好讀异吻,比較一下上面的范例裹赴,使用參考式的文章本身只有 81 個字符,但是用行內(nèi)形式的卻會增加到 176 個字元诀浪,如果是用純 HTML 格式來寫棋返,會有 234 個字元,在 HTML 格式中雷猪,標(biāo)簽比文本還要多睛竣。

使用 Markdown 的參考式鏈接,可以讓文件更像是瀏覽器最后產(chǎn)生的結(jié)果求摇,讓你可以把一些標(biāo)記相關(guān)的元數(shù)據(jù)移到段落文字之外射沟,你就可以增加鏈接而不讓文章的閱讀感覺被打斷。

強調(diào)

Markdown 使用星號(*)和底線(_)作為標(biāo)記強調(diào)字詞的符號与境,被 *_ 包圍的字詞會被轉(zhuǎn)成用 <em> 標(biāo)簽包圍验夯,用兩個 *_ 包起來的話,則會被轉(zhuǎn)成 <strong>摔刁,例如:

*single asterisks*
_single underscores_
**double asterisks**
__double underscores__

會轉(zhuǎn)成:

<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>

你可以隨便用你喜歡的樣式挥转,唯一的限制是,你用什么符號開啟標(biāo)簽共屈,就要用什么符號結(jié)束绑谣。
強調(diào)也可以直接插在文字中間:

un*frigging*believable

但是如果你的 *_ 兩邊都有空白的話,它們就只會被當(dāng)成普通的符號拗引。

如果要在文字前后直接插入普通的星號或底線借宵,你可以用反斜線:

\*this text is surrounded by literal asterisks\*

代碼

如果要標(biāo)記一小段行內(nèi)代碼,你可以用反引號把它包起來(`` `)矾削,例如:

Use the `printf()` function.

會產(chǎn)生:

<p>Use the <code>printf()</code> function.</p>

如果要在代碼區(qū)段內(nèi)插入反引號壤玫,你可以用多個反引號來開啟和結(jié)束代碼區(qū)段:

``There is a literal backtick (`) here.``

這段語法會產(chǎn)生:

<p><code>There is a literal backtick (`) here.</code></p>

代碼區(qū)段的起始和結(jié)束端都可以放入一個空白豁护,起始端后面一個,結(jié)束端前面一個欲间,這樣你就可以在區(qū)段的一開始就插入反引號:

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

會產(chǎn)生:

<p>A single backtick in a code span: <code>`</code></p>

<p>A backtick-delimited string in a code span: <code>`foo`</code></p>

在代碼區(qū)段內(nèi)择镇,& 和尖括號會被自動地轉(zhuǎn)成 HTML 實體,這使得插入 HTML 原始碼變得很容易括改,Markdown 會把下面這段:

Please don't use any `<blink>` tags.

轉(zhuǎn)為:

<p>Please don't use any <code><blink></code> tags.</p>

你也可以這樣寫:

`—` is the decimal-encoded equivalent of `—`.

以產(chǎn)生:

<p><code>—</code> is the decimal-encodedequivalent of <code>—</code>.</p>

圖片

很明顯地腻豌,要在純文字應(yīng)用中設(shè)計一個「自然」的語法來插入圖片是有一定難度的。

Markdown 使用一種和鏈接很相似的語法來標(biāo)記圖片嘱能,同樣也允許兩種樣式: 行內(nèi)式參考式吝梅。

行內(nèi)式的圖片語法看起來像是:

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

詳細(xì)敘述如下:

  • 一個驚嘆號 !
  • 接著一個方括號,里面放上圖片的替代文字
  • 接著一個普通括號惹骂,里面放上圖片的網(wǎng)址苏携,最后還可以用引號包住并加上選擇性的 'title' 文字。

參考式的圖片語法則長得像這樣:

![Alt text][id]

「id」是圖片參考的名稱对粪,圖片參考的定義方式則和連結(jié)參考一樣:

[id]: url/to/image "Optional title attribute"

到目前為止右冻, Markdown 還沒有辦法指定圖片的寬高,如果你需要的話著拭,你可以使用普通的 <img> 標(biāo)簽纱扭。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市儡遮,隨后出現(xiàn)的幾起案子乳蛾,更是在濱河造成了極大的恐慌,老刑警劉巖鄙币,帶你破解...
    沈念sama閱讀 211,423評論 6 491
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件肃叶,死亡現(xiàn)場離奇詭異,居然都是意外死亡十嘿,警方通過查閱死者的電腦和手機因惭,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,147評論 2 385
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來绩衷,“玉大人蹦魔,你說我怎么就攤上這事〈狡福” “怎么了版姑?”我有些...
    開封第一講書人閱讀 157,019評論 0 348
  • 文/不壞的土叔 我叫張陵柱搜,是天一觀的道長迟郎。 經(jīng)常有香客問我,道長聪蘸,這世上最難降的妖魔是什么宪肖? 我笑而不...
    開封第一講書人閱讀 56,443評論 1 283
  • 正文 為了忘掉前任表制,我火速辦了婚禮,結(jié)果婚禮上控乾,老公的妹妹穿的比我還像新娘么介。我一直安慰自己,他們只是感情好蜕衡,可當(dāng)我...
    茶點故事閱讀 65,535評論 6 385
  • 文/花漫 我一把揭開白布壤短。 她就那樣靜靜地躺著,像睡著了一般慨仿。 火紅的嫁衣襯著肌膚如雪久脯。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,798評論 1 290
  • 那天镰吆,我揣著相機與錄音帘撰,去河邊找鬼。 笑死万皿,一個胖子當(dāng)著我的面吹牛摧找,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播牢硅,決...
    沈念sama閱讀 38,941評論 3 407
  • 文/蒼蘭香墨 我猛地睜開眼蹬耘,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了减余?” 一聲冷哼從身側(cè)響起婆赠,我...
    開封第一講書人閱讀 37,704評論 0 266
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎佳励,沒想到半個月后休里,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,152評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡赃承,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,494評論 2 327
  • 正文 我和宋清朗相戀三年妙黍,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片瞧剖。...
    茶點故事閱讀 38,629評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡拭嫁,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出抓于,到底是詐尸還是另有隱情做粤,我是刑警寧澤,帶...
    沈念sama閱讀 34,295評論 4 329
  • 正文 年R本政府宣布捉撮,位于F島的核電站怕品,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏巾遭。R本人自食惡果不足惜肉康,卻給世界環(huán)境...
    茶點故事閱讀 39,901評論 3 313
  • 文/蒙蒙 一闯估、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧吼和,春花似錦涨薪、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,742評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至末捣,卻和暖如春光督,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背塔粒。 一陣腳步聲響...
    開封第一講書人閱讀 31,978評論 1 266
  • 我被黑心中介騙來泰國打工结借, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人卒茬。 一個月前我還...
    沈念sama閱讀 46,333評論 2 360
  • 正文 我出身青樓船老,卻偏偏與公主長得像,于是被迫代替她去往敵國和親圃酵。 傳聞我的和親對象是個殘疾皇子柳畔,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,499評論 2 348

推薦閱讀更多精彩內(nèi)容