區(qū)塊引用 Blockquotes
> 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.
標(biāo)題
Markdown 支持兩種標(biāo)題的語(yǔ)法,類Setext和類atx形式。
類 Setext 形式是用底線的形式,利用=(最高階標(biāo)題)和-(第二階標(biāo)題),例如:
This is an H1
=============
This is an H2
-------------
任何數(shù)量的=和-都可以有效果。
類 Atx 形式則是在行首插入 1 到 6 個(gè)#,對(duì)應(yīng)到標(biāo)題 1 到 6 階,例如:
# 這是 H1
## 這是 H2
###### 這是 H6
引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法,包括標(biāo)題、列表、代碼區(qū)塊等:
> ## 這是一個(gè)標(biāo)題。
>
> 1.? 這是第一行列表項(xiàng)。
> 2.? 這是第二行列表項(xiàng)。
>
> 給出一些例子代碼:
>
> ? ? ? ? ? return shell_exec("echo $input | $markdown_script");
列表
Markdown 支持有序列表和無(wú)序列表。
無(wú)序列表使用星號(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
代碼區(qū)塊
和程序相關(guān)的寫作或是標(biāo)簽語(yǔ)言原始碼通常會(huì)有已經(jīng)排版好的代碼區(qū)塊,通常這些區(qū)塊我們并不希望它以一般段落文件的方式去排版,而是照原來(lái)的樣子顯示,Markdown 會(huì)用
和標(biāo)簽來(lái)把代碼區(qū)塊包起來(lái)。要在 Markdown 中建立代碼區(qū)塊很簡(jiǎn)單,只要簡(jiǎn)單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以。
如果要標(biāo)記一小段行內(nèi)代碼,你可以用反引號(hào)把它包起來(lái)(`)
分隔線
你可以在一行中用三個(gè)以上的星號(hào)、減號(hào)、底線來(lái)建立一個(gè)分隔線,行內(nèi)不能有其他東西。你也可以在星號(hào)或是減號(hào)中間插入空格。下面每種寫法都可以建立分隔線:
* * *
***
*****
- - -
---------------------------------------
強(qiáng)調(diào)
Markdown 使用星號(hào)(*)和底線(_)作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào),被*或_包圍的字詞會(huì)被轉(zhuǎn)成用標(biāo)簽包圍,用兩個(gè)*或_包起來(lái)的話,則會(huì)被轉(zhuǎn)成
鏈接
Markdown 支持兩種形式的鏈接語(yǔ)法:行內(nèi)式和參考式兩種形式。
不管是哪一種,鏈接文字都是用 [方括號(hào)] 來(lái)標(biāo)記。
要建立一個(gè)行內(nèi)式的鏈接,只要在方塊括號(hào)后面緊接著圓括號(hào)并插入網(wǎng)址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網(wǎng)址后面,用雙引號(hào)把 title 文字包起來(lái)即可,例如:
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
參考式的鏈接是在鏈接文字的括號(hào)后面再接上另一個(gè)方括號(hào),而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記:
This is [an example][id] reference-style link.
你也可以選擇性地在兩個(gè)方括號(hào)中間加上一個(gè)空格:
This is [an example] [id] reference-style link.
接著,在文件的任意處,你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來(lái):
[id]: http://example.com/? "Optional Title Here"
鏈接內(nèi)容定義的形式為:
方括號(hào)(前面可以選擇性地加上至多三個(gè)空格來(lái)縮進(jìn)),里面輸入鏈接文字
接著一個(gè)冒號(hào)
接著一個(gè)以上的空格或制表符
接著鏈接的網(wǎng)址
選擇性地接著 title 內(nèi)容,可以用單引號(hào)、雙引號(hào)或是括弧包著
下面這三種鏈接的定義都是相同:
[foo]: http://example.com/? "Optional Title Here"
[foo]: http://example.com/? 'Optional Title Here'
[foo]: http://example.com/? (Optional Title Here)