"https://en.wikipedia.org/wiki/Markdown#Example
區(qū)塊元素
段落和換行
一個(gè) Markdown 段落是由一個(gè)或多個(gè)連續(xù)的文本行組成嚣鄙,它的前后要有一個(gè)以上的空行。普通段落不該用空格或制表符來縮進(jìn)七问。
標(biāo)題
Markdown 支持兩種標(biāo)題的語法骗露,類 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 階躬存,例如:
# This is an H1
## This is an H2
###### This is an H3
區(qū)塊引用 Blockquotes
Markdown 標(biāo)記區(qū)塊引用是使用類似 email 中用 >的引用方式。如果你還熟悉在 email 信件中的引言部分舀锨,你就知道怎么Markdown 文件中建立一個(gè)區(qū)塊引用岭洲,那會(huì)看起來像是你自己先斷好行,然后在每行的最前面加上 >:
> 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. Suspendisseid sem consectetuer libero luctus adipiscing.
區(qū)塊引用可以嵌套(例如:引用內(nèi)的引用)坎匿,只要根據(jù)層次加上不同數(shù)量的 >:
> This is the first level of quoting.
>
>> This is nested blockquote.
>> Back to the first level.
引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法盾剩,包括標(biāo)題、列表替蔬、代碼區(qū)塊等:
> ## 這是一個(gè)標(biāo)題告私。
>
> 1. 這是第一行列表項(xiàng)。
> 2. 這是第二行列表項(xiàng)承桥。
> > 給出一些例子代碼:
>
> return shell_exec("echo $input | $markdown_script");
列表
無序列表使用星號(hào)驻粟、加號(hào)或是減號(hào)作為列表標(biāo)記:
* Red
* Green
* Blue
或者:
+ Red
+ Green
+ Blue
或者
- Red
- Green
- Blue
有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn):
1. Red
2. Green
3. Blue
如果要放代碼區(qū)塊的話,該區(qū)塊就需要縮進(jìn)兩次凶异,也就是 8 個(gè)空格或是 2 個(gè)制表符:
* 一列表項(xiàng)包含一個(gè)列表區(qū)塊:
\tab\tab<代碼寫在這>
如果在行首出現(xiàn)數(shù)字-句點(diǎn)-空白蜀撑,你可以在句點(diǎn)前面加上反斜杠:
1986\. What a great season.
代碼區(qū)塊
建立代碼區(qū)塊很簡單,只要簡單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以剩彬,例如酷麦,下面的輸入:
這是一個(gè)普通段落:
這是一個(gè)代碼區(qū)塊。
在代碼區(qū)塊里面喉恋, &沃饶、 <和 >會(huì)自動(dòng)轉(zhuǎn)成 HTML 實(shí)體,這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼轻黑,只需要復(fù)制貼上糊肤,再加上縮進(jìn)就可以了,剩下的 Markdown 都會(huì)幫你處理苔悦,例如:
<div class="footer">
? 2004 Foo Corporation
</div>
分隔線
你可以在一行中用三個(gè)以上的星號(hào)轩褐、減號(hào)、底線來建立一個(gè)分隔線:
***
---
----------
區(qū)段元素
鏈接
Markdown 支持兩種形式的鏈接語法: 行內(nèi)式和參考式兩種形式玖详。
不管是哪一種把介,鏈接文字都是用 [方括號(hào)] 來標(biāo)記勤讽。
要建立一個(gè)行內(nèi)式的鏈接,只要在方塊括號(hào)后面緊接著圓括號(hào)并插入網(wǎng)址鏈接即可拗踢,如果你還想要加上鏈接的 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.
參考式的鏈接是在鏈接文字的括號(hào)后面再接上另一個(gè)方括號(hào)诸狭,而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記:
This is [an example][id] reference-style link.
接著,在文件的任意處君纫,你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來:
[id]: http://example.com/ "Optional Title Here"
隱式鏈接標(biāo)記功能讓你可以省略指定鏈接標(biāo)記驯遇,這種情形下,鏈接標(biāo)記會(huì)視為等同于鏈接文字蓄髓,要用隱式鏈接標(biāo)記只要在鏈接文字后面加上一個(gè)空的方括號(hào)叉庐,如果你要讓 "Google" 鏈接到 google.com,你可以簡化成:
[Google][]
然后定義鏈接內(nèi)容:
[Google]: http://google.com/
鏈接的定義可以放在文件中的任何一個(gè)地方会喝,我比較偏好直接放在鏈接出現(xiàn)段落的后面陡叠,你也可以把它放在文件最后面,就像是注解一樣肢执。
下面是一個(gè)參考式鏈接的范例:
I get 10 times more traffic from [Google] [1] than from[Yahoo] [2] or [MSN] [3].
強(qiáng)調(diào)
Markdown 使用星號(hào)(*)和底線(_)作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào)
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
*** Other ***
代碼
如果要標(biāo)記一小段行內(nèi)代碼枉阵,你可以用反引號(hào)把它包起來(`),例如:
Use the `printf()` function.
如果要在代碼區(qū)段內(nèi)插入反引號(hào)预茄,你可以用多個(gè)反引號(hào)來開啟和結(jié)束代碼區(qū)段:
``There is a literal backtick (`) here.``
圖片
行內(nèi)式的圖片語法看起來像是:
![毛杰](/Users/mao/Downloads/mao/520.jpg)
![毛杰](/Users/mao/Downloads/mao/520.jpg "Optional title")
參考式的圖片語法則長得像這樣:
![Alt text][id]
「id」是圖片參考的名稱兴溜,圖片參考的定義方式則和鏈接參考一樣:
[id]: url/to/image "Optional title attribute"
到目前為止, Markdown 還沒有辦法指定圖片的寬高反璃,如果你需要的話昵慌,你可以使用普通的<img>
標(biāo)簽
其它
Markdown 支持以比較簡短的自動(dòng)鏈接形式來處理網(wǎng)址和電子郵件信箱,只要是用方括號(hào)包起來淮蜈, Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接斋攀。一般網(wǎng)址的鏈接文字就和鏈接地址一樣,例如:
http://example.com/
或
address@example.com
Markdown 支持以下這些符號(hào)前面加上反斜杠來幫助插入普通的符號(hào):
\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 底線
{} 花括號(hào)
[] 方括號(hào)
() 括弧
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)