1.什么是Markdown
Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」
2.行內(nèi)HTML
Markdown 的語(yǔ)法有個(gè)主要的目的:用來(lái)作為一種網(wǎng)絡(luò)內(nèi)容的寫作用語(yǔ)言
請(qǐng)注意糯崎,在 HTML 區(qū)塊標(biāo)簽(div、p...)中不能使用Markdown 語(yǔ)法。在區(qū)段標(biāo)簽(span、del葫辐、cite...)中可以使用
3.特殊字符自動(dòng)轉(zhuǎn)換
Markdown 允許直接使用這些符號(hào) & < >...
*html實(shí)體不會(huì)被自動(dòng)轉(zhuǎn)換--?
<a href="">百度一下,你就知道</a>
不過(guò)需要注意的是,code 范圍內(nèi)聂示,不論是行內(nèi)還是區(qū)塊, < 和 & 兩個(gè)符號(hào)都一定會(huì)被轉(zhuǎn)換成 HTML 實(shí)體簇秒,這項(xiàng)特性讓你可以很容易地用 Markdown 寫 HTML code
4.區(qū)塊元素
Markdown 中 email 式的 區(qū)塊引言 和多段落的 列表 在使用換行來(lái)排版的時(shí)候鱼喉,不但更好用,還更好閱讀趋观。
4.1.標(biāo)題
Markdown 支持兩種標(biāo)題的語(yǔ)法扛禽,Setext 和 atx 形式
Setext 形式是用底線的形式,利用 = (一級(jí)標(biāo)題)和 - (二級(jí)標(biāo)題)皱坛,任何數(shù)量的 = 和 - 都可以有效果例如:
這是H1標(biāo)題
這是H2標(biāo)題
Atx 形式則是在行首插入 1 到 6 個(gè) # 编曼,對(duì)應(yīng)到標(biāo)題 1 到 6 級(jí),(可以選擇性地「關(guān)閉」atx 樣式的標(biāo)題剩辟,這純粹只是美觀用的)例如:
This is an H1
This is an H2
This is an H3
This is an H4
This is an H5
This is an H6
4.2區(qū)塊引言
- Markdown 也允許只在整個(gè)段落的第一行最前面加上>如:
這是一首詩(shī):床前明月光掐场,疑似地上霜,舉頭望明月贩猎,低頭思故鄉(xiāng)刻肄。 這一段還沒(méi)結(jié)束嗎?
這是一首兒歌:門前大橋下,游過(guò)一群鴨融欧,快來(lái)快來(lái)數(shù)一數(shù)二敏弃、四、六噪馏、七麦到、八。
- 區(qū)塊引言可以有級(jí)別(例如:引言內(nèi)的引言)欠肾,只要根據(jù)級(jí)別加上不同數(shù)量的>
這是一段內(nèi)容
這是一段里面的內(nèi)容
這是另一段內(nèi)容
- 引言的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法瓶颠,包括標(biāo)題、列表刺桃、程序代碼區(qū)塊等
這是引言標(biāo)題
這是引言內(nèi)容
4.3列表
- Markdown 支持有序列表和無(wú)序列表
- 無(wú)序列表使用星號(hào)*粹淋、加號(hào)+或是減號(hào)-作為列表標(biāo)記
- 有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)
項(xiàng)目標(biāo)記后面則一定要接著至少一個(gè)空白或 tab
- 列表中使用引言
列表中使用引言需要縮排
- 如果要放程序代碼區(qū)塊的話,該區(qū)塊就需要縮排兩次
<?php
echo 'hello world';
?>
4.3程序代碼區(qū)塊
要在 Markdown 中建立程序代碼區(qū)塊很簡(jiǎn)單瑟慈,只要簡(jiǎn)單地縮排 4 個(gè)空白或是 1 個(gè) tab 就可以如:
<div class="footer">
在程序代碼區(qū)塊里面桃移, & 、 < 和 > 會(huì)自動(dòng)轉(zhuǎn)成 HTML 實(shí)體
?
</div>
4.4分隔線
- 你可以在一行中用三個(gè)或以上的星號(hào)葛碧、減號(hào)借杰、底線來(lái)建立一個(gè)分隔線,行內(nèi)不能有其他東西
- 你也可以在星號(hào)中間插入空白
如:
5.區(qū)段元素
5.1鏈接
Markdown 支持兩種形式的鏈接語(yǔ)法: 行內(nèi)和參考兩種形式进泼。
不管是哪一種蔗衡,鏈接的文字都是用 [方括號(hào)] 來(lái)標(biāo)記纤虽。
行內(nèi)形式的鏈接
只要在方塊括號(hào)后面馬上接著括號(hào)并插入網(wǎng)址鏈接即可,如果你還想要加上鏈接的 title 文字绞惦,只要在網(wǎng)址后面逼纸,用雙引號(hào)把 title 文字包起來(lái)即可,例如:
參考形式的鏈接
使用另外一個(gè)方括號(hào)接在鏈接文字的括號(hào)后面济蝉,而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)簽:
[鏈接文字][辨識(shí)鏈接標(biāo)簽]
[辨識(shí)鏈接標(biāo)簽]:
[百度][id]
[id]: http://www.baidu.com "title"
鏈接定義的形式為:
- 方括號(hào)杰刽,里面輸入鏈接的辨識(shí)用標(biāo)簽
- 接著一個(gè)冒號(hào)
- 接著一個(gè)以上的空白或 tab
- 接著鏈接的網(wǎng)址
- 選擇性地接著 title 內(nèi)容,可以用單引號(hào)堆生、雙引號(hào)或是括號(hào)包著
鏈接的定義可以放在文檔中的任何一個(gè)地方,我比較偏好直接放在鏈接出現(xiàn)段落的后面雷酪,也可以把它放在文檔最后面淑仆,就像是批注一樣。
如:
最近[baidu][1]不能使用,[google][]也不能使用哥力,那還有什么能用呢?
[1]: http://www.baidu.com
[google]: http://www.google.com
5.2強(qiáng)調(diào)
Markdown使用星號(hào)或下劃線作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào)
使用星號(hào)或下劃線包圍的會(huì)變?yōu)樾斌w
使用兩個(gè)星號(hào)或下劃線包圍的會(huì)變?yōu)榇煮w
*aaaaaaaaa*
_bbbbbbbbbb_
**aaaaaaaa**
__bbbbbbbbbb__
注意符號(hào)兩邊不能有空白
5.3程序代碼
如果要標(biāo)記一小段行內(nèi)程序代碼可以使用蔗怠,反引號(hào)引起來(lái)
要想獲取字符串長(zhǎng)度請(qǐng)使用`strlen()`函數(shù)
程序中代碼中的&與<會(huì)被轉(zhuǎn)成html實(shí)體,容易插入html代碼
<a href="">aaa</a>
5.4圖片
Markdown 使用一種和鏈接很相似的語(yǔ)法來(lái)標(biāo)記圖片,同樣也允許兩種樣式: 行內(nèi)和參考
行內(nèi)圖片的語(yǔ)法:
- 一個(gè)驚嘆號(hào) !
- 接著一個(gè)方括號(hào)吩跋,里面放上圖片的替換文字
- 接著一個(gè)普通括號(hào)寞射,里面放上圖片的網(wǎng)址,最后還可以用引號(hào)包住并加上 選擇性的 'title' 文字锌钮。
[圖片上傳失敗...(image-4a964c-1528699767654)]
[圖片上傳失敗...(image-81b268-1528699767657)]
參考式的圖片語(yǔ)法則
![alt text][id]
[id]: ./1.jpg "美女"
注意:Markdown沒(méi)有辦法指定圖片的寬高桥温,如果想要指定寬高請(qǐng)使用html中的img標(biāo)簽
6.其它
6.1自動(dòng)鏈接
Markdown 支持比較簡(jiǎn)短的自動(dòng)鏈接形式來(lái)處理網(wǎng)址和電子郵件信箱,只要是用方括號(hào)包起來(lái)
如:
<http://www.baidu.com>
<bienzhu@lampbrother.net>
6.2轉(zhuǎn)義字符
Markdown 可以利用反斜杠來(lái)插入一些在語(yǔ)法中有其它意義的符號(hào)
Markdown 支持在下面這些符號(hào)前面加上反斜杠來(lái)幫助插入普通的符號(hào):
\ 反斜杠
` 反引號(hào)
* 星號(hào)
_ 底線
{} 大括號(hào)
[] 方括號(hào)
() 括號(hào)
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)