Markdown使用文檔

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)
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末梁丘,一起剝皮案震驚了整個(gè)濱河市侵浸,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌氛谜,老刑警劉巖掏觉,帶你破解...
    沈念sama閱讀 218,122評(píng)論 6 505
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異值漫,居然都是意外死亡澳腹,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,070評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門杨何,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)酱塔,“玉大人,你說(shuō)我怎么就攤上這事危虱⊙泳桑” “怎么了?”我有些...
    開封第一講書人閱讀 164,491評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵槽地,是天一觀的道長(zhǎng)迁沫。 經(jīng)常有香客問(wèn)我芦瘾,道長(zhǎng),這世上最難降的妖魔是什么集畅? 我笑而不...
    開封第一講書人閱讀 58,636評(píng)論 1 293
  • 正文 為了忘掉前任近弟,我火速辦了婚禮,結(jié)果婚禮上挺智,老公的妹妹穿的比我還像新娘祷愉。我一直安慰自己,他們只是感情好赦颇,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,676評(píng)論 6 392
  • 文/花漫 我一把揭開白布二鳄。 她就那樣靜靜地躺著,像睡著了一般媒怯。 火紅的嫁衣襯著肌膚如雪订讼。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,541評(píng)論 1 305
  • 那天扇苞,我揣著相機(jī)與錄音欺殿,去河邊找鬼。 笑死鳖敷,一個(gè)胖子當(dāng)著我的面吹牛脖苏,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播定踱,決...
    沈念sama閱讀 40,292評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼棍潘,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了崖媚?” 一聲冷哼從身側(cè)響起蜒谤,我...
    開封第一講書人閱讀 39,211評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎至扰,沒(méi)想到半個(gè)月后鳍徽,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,655評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡敢课,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,846評(píng)論 3 336
  • 正文 我和宋清朗相戀三年阶祭,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片直秆。...
    茶點(diǎn)故事閱讀 39,965評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡濒募,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出圾结,到底是詐尸還是另有隱情瑰剃,我是刑警寧澤,帶...
    沈念sama閱讀 35,684評(píng)論 5 347
  • 正文 年R本政府宣布筝野,位于F島的核電站晌姚,受9級(jí)特大地震影響粤剧,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜挥唠,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,295評(píng)論 3 329
  • 文/蒙蒙 一抵恋、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧宝磨,春花似錦弧关、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,894評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至窿祥,卻和暖如春株憾,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背壁肋。 一陣腳步聲響...
    開封第一講書人閱讀 33,012評(píng)論 1 269
  • 我被黑心中介騙來(lái)泰國(guó)打工号胚, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留籽慢,地道東北人浸遗。 一個(gè)月前我還...
    沈念sama閱讀 48,126評(píng)論 3 370
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像箱亿,于是被迫代替她去往敵國(guó)和親跛锌。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,914評(píng)論 2 355

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

  • Markdown: Syntax 概述 哲學(xué) 行內(nèi) HTML 特殊字符自動(dòng)轉(zhuǎn)換 區(qū)塊元素 段落和換行 標(biāo)題 區(qū)塊引...
    未知代碼閱讀 7,511評(píng)論 6 50
  • 轉(zhuǎn)抄日期:2016年06月05日 中文原文地址:http://www.markdown.cn 英文原文地址:ht...
    ChristieIn閱讀 905評(píng)論 0 1
  • 說(shuō)明:本文原載于圖靈社區(qū)網(wǎng)站届惋,本次轉(zhuǎn)載時(shí)為方便閱讀髓帽,并修改個(gè)別用語(yǔ)。 Markdown: Syntax 概述 哲學(xué)...
    tonyzheng1閱讀 774評(píng)論 0 49
  • 為什么學(xué)習(xí)Markdown 自從搭建了 Hexo 博客之后脑豹,發(fā)現(xiàn)還有 Markdown 這種寫文章的方法郑藏,想到以后...
    lifeColder閱讀 20,158評(píng)論 10 217
  • 童戲——虐童 幼稚園的老師,對(duì)孩童們可是堆起了戲虐的滿足來(lái)瘩欺。生活的苦悶必盖,收入的微薄,令她堵著諸多的不快俱饿。愛(ài)情的失卻...
    南溪向南北歌流海閱讀 263評(píng)論 0 0