Markdown語法入門

標(biāo)題

Markdown支持兩種標(biāo)題的語法砸喻,類Setext和類atx形式欢瞪。

類Setext

使用底線的形式敌完,利用 = (最高階標(biāo)題)和 - (第二階標(biāo)題),=或-需兩個(gè)以上钝荡。

語法:
H1標(biāo)題
====
H2標(biāo)題
----

效果:

H1標(biāo)題

H2標(biāo)題

類Atx

在行首插入1到6個(gè)# 街立,對(duì)應(yīng)到標(biāo)題1到6階,也可以選擇閉合類 atx 樣式的標(biāo)題埠通,這純粹只是美觀用的赎离,閉合類 atx 即在行尾加上#,而行尾的#數(shù)量也不用和開頭一樣(行首的井字符數(shù)量決定標(biāo)題的階數(shù))

語法(非閉合類):
# H1標(biāo)題
## H2標(biāo)題
### H3標(biāo)題
#### H4標(biāo)題
##### H5標(biāo)題
###### H6標(biāo)題

語法(閉合類):
# H1標(biāo)題 #
## H2標(biāo)題 ##
### H3標(biāo)題 ###
#### H4標(biāo)題 ###
##### H5標(biāo)題 ##
###### H6標(biāo)題 ######

效果:

H1標(biāo)題

H2標(biāo)題

H3標(biāo)題

H4標(biāo)題

H5標(biāo)題
H6標(biāo)題

列表

Markdown 支持有序列表和無序列表端辱。

無序列表

無序列表使用星號(hào)梁剔、加號(hào)或是減號(hào)作為列表標(biāo)記:

語法:
* 列表1
- 列表二
+ 列表三

效果:

  • 列表1
  • 列表二
  • 列表三

有序列表

有序列表則使用:數(shù)字+英文句點(diǎn)+空格,標(biāo)記上使用的數(shù)字并不會(huì)影響輸出的 HTML 結(jié)果舞蔽,官方建議第一個(gè)項(xiàng)目最好還是從 1. 開始荣病,因?yàn)?Markdown 未來可能會(huì)支持有序列表的 start 屬性。

語法:
1. 列表1
3. 列表2
2. 列表3

效果:

  1. 列表1
  2. 列表2
  3. 列表3

列表項(xiàng)目可以包含多個(gè)段落渗柿,每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符:
語法:
1. 列表1个盆,段落1

    列表1,段落2

2.  列表2朵栖,段落1

效果:

  1. 列表1颊亮,段落1

    列表1,段落2

  2. 列表2混槐,段落1

如果要在列表項(xiàng)目?jī)?nèi)放進(jìn)引用编兄,那 > 就需要縮進(jìn)轩性,如果要放代碼區(qū)塊的話声登,該區(qū)塊就需要縮進(jìn)兩次,也就是 8 個(gè)空格或是 2 個(gè)制表符
語法:
+ A list item with a blockquote:

    > This is a blockquote
    > inside a list item.
        System.out.pringln(hello);

效果:

  • A list item with a blockquote:

    This is a blockquote
    inside a list item.
    System.out.pringln(hello);

若遇到需要顯示數(shù)字+英文句號(hào)+空格的時(shí)候揣苏,則可以使用轉(zhuǎn)義符:
語法:2017\. 你好
效果:2017. 你好

引用

在 Markdown 中悯嗓,引用只需要在文本前加入 > ,可以在每行的最前面加上 > 卸察,也允許只在整個(gè)段落的第一行最前面加上 >脯厨,區(qū)塊引用可以嵌套(例如:引用內(nèi)的引用),只要根據(jù)層次加上不同數(shù)量的 >坑质。

語法:
> 這是一段引用
引用
>> 嵌套引用
>>> 三層嵌套

效果:

這是一段引用
引用

嵌套引用

三層嵌套

引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法合武,包括標(biāo)題、列表涡扼、代碼區(qū)塊等

語法:
> ## 這是一個(gè)標(biāo)題稼跳。
>
> 1. 這是第一行列表項(xiàng)。
> 2. 這是第二行列表項(xiàng)吃沪。
>
> 代碼:
>
> System.out.println("hello");

效果

這是一個(gè)標(biāo)題汤善。

  1. 這是第一行列表項(xiàng)。
  2. 這是第二行列表項(xiàng)。

代碼:

System.out.println("hello");

鏈接

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

行內(nèi)式

鏈接文字用 [] 來標(biāo)記不狮,后面緊接著圓括號(hào)并插入網(wǎng)址鏈接,如果還想要加上鏈接的 title 文字在旱,只要在網(wǎng)址后面摇零,用雙引號(hào)把 title 文字包起來即可
語法:[]()
示例:[我的主頁](http://www.reibang.com/u/8a3115bb299c "title")
效果:我的主頁

參考式

鏈接文字同樣用 [] 來標(biāo)記,后面再接上另一個(gè)方括號(hào)桶蝎,而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記遂黍,接著,在文件的任意處俊嗽,你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來雾家。
示例:

這是[我的主頁] [home1]
[home1]: http://www.reibang.com/u/8a3115bb299c "title1"
這是[我的主頁] [home2]
[home2]: http://www.reibang.com/u/8a3115bb299c (title2)
這是[我的主頁] [home3]
[home3]: <http://www.reibang.com/u/8a3115bb299c> (title3)

效果:
這是[我的主頁] [home1]
[home1]: http://www.reibang.com/u/8a3115bb299c "title1"
這是[我的主頁] [home2]
[home2]: http://www.reibang.com/u/8a3115bb299c (title2)
這是[我的主頁] [home3]
[home3]: http://www.reibang.com/u/8a3115bb299c (title3)

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

  • 方括號(hào)里面輸入鏈接文字
  • 接著一個(gè)冒號(hào)
  • 接著一個(gè)以上的空格或制表符
  • 接著鏈接的網(wǎng)址,鏈接網(wǎng)址也可以用尖括號(hào)包起來
  • 選擇性地接著 title 內(nèi)容绍豁,可以用雙引號(hào)或是括弧包著

隱式鏈接標(biāo)記功能讓你可以省略指定鏈接標(biāo)記芯咧,鏈接標(biāo)記會(huì)視為等同于鏈接文字,要用隱式鏈接標(biāo)記只要在鏈接文字后面加上一個(gè)空的方括號(hào)竹揍。
示例:

這是[我的主頁] []
[我的主頁]: <http://www.reibang.com/u/8a3115bb299c> (title4)

效果
這是[我的主頁] []
[我的主頁]: http://www.reibang.com/u/8a3115bb299c (title4)

參考式的鏈接其實(shí)重點(diǎn)不在于它比較好寫敬飒,而是它比較好讀,讓你可以把一些標(biāo)記相關(guān)的元數(shù)據(jù)移到段落文字之外芬位,增加鏈接而不讓文章的閱讀感覺被打斷无拗。

自動(dòng)鏈接

Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來處理網(wǎng)址和電子郵件信箱,只要是用尖括號(hào)包起來昧碉, Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接英染。
語法:

<http://www.reibang.com/u/8a3115bb299c>
<hello@qq.com>

效果:
http://www.reibang.com/u/8a3115bb299c
hello@qq.com

圖片

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

行內(nèi)式

語法:![]()
示例:![榮耀](http://img3.a0bi.com/upload/ttq/20150406/1428301499455.jpg "榮耀")
效果:

榮耀
榮耀

詳細(xì)敘述如下:

  • 一個(gè)驚嘆號(hào) !
  • 接著一個(gè)方括號(hào)四康,里面放上圖片的替代文字
  • 接著一個(gè)普通括號(hào),里面放上圖片的網(wǎng)址狭握,最后還可以用引號(hào)包住并加上 選擇性的title文字闪金。

參考式

語法:![][]
示例:

![榮耀][pic]
[pic]: http://img3.a0bi.com/upload/ttq/20150406/1428301499455.jpg

效果:
![榮耀][pic]
[pic]: http://img3.a0bi.com/upload/ttq/20150406/1428301499455.jpg

[pic]是圖片參考的名稱,圖片參考的定義方式則和鏈接參考一樣

粗體與斜體

用兩個(gè)*或者_ 包含一段文本就是粗體的語法论颅,用一個(gè) *或者_ 包含一段文本就是斜體的語法哎垦。
語法:

**我是粗體**

__我是粗體__

*我是斜體*

_我是斜體_

效果:
我是粗體

我是粗體

我是斜體

我是斜體

代碼框

要在 Markdown 中建立代碼區(qū)塊很簡(jiǎn)單,只要簡(jiǎn)單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以

效果:

public static void main(String[] args) {
    System.out.print("Hello World!");
}

也可以使用將代碼文本包含起來 語法:
public static void main(String[] args) {
System.out.print("Hello World!");
}
```

效果:

public static void main(String[] args) {
    System.out.print("Hello World!");
}

如果要標(biāo)記一小段行內(nèi)代碼恃疯,你可以用反引號(hào)(`)把它包起來漏设。
示例

這里有一個(gè)代碼:`code`。

效果:
這里有一個(gè)代碼:code澡谭。

分割線

你可以在一行中用三個(gè)以上的星號(hào)愿题、減號(hào)损俭、底線來建立一個(gè)分隔線,行內(nèi)不能有其他東西潘酗。你也可以在星號(hào)或是減號(hào)中間插入空格杆兵。下面每種寫法都可以建立分隔線,減號(hào)上方需空一行仔夺,否則將會(huì)是標(biāo)題的效果:
語法:

*********
* *  *
_______ ___

--------- -

效果:





反斜杠

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號(hào)琐脏,支持的符號(hào)包括以下這些:

\   反斜線
`   反引號(hào)
*   星號(hào)
_   底線
{}  花括號(hào)
[]  方括號(hào)
()  括弧
#   井字號(hào)
+   加號(hào)
-   減號(hào)
.   英文句點(diǎn)
!   驚嘆號(hào)

參考文章:Markdown 語法說明 (簡(jiǎn)體中文版)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市缸兔,隨后出現(xiàn)的幾起案子日裙,更是在濱河造成了極大的恐慌,老刑警劉巖惰蜜,帶你破解...
    沈念sama閱讀 212,029評(píng)論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件昂拂,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡抛猖,警方通過查閱死者的電腦和手機(jī)格侯,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,395評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來财著,“玉大人联四,你說我怎么就攤上這事〕沤蹋” “怎么了朝墩?”我有些...
    開封第一講書人閱讀 157,570評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)伟姐。 經(jīng)常有香客問我收苏,道長(zhǎng),這世上最難降的妖魔是什么玫镐? 我笑而不...
    開封第一講書人閱讀 56,535評(píng)論 1 284
  • 正文 為了忘掉前任倒戏,我火速辦了婚禮怠噪,結(jié)果婚禮上恐似,老公的妹妹穿的比我還像新娘。我一直安慰自己傍念,他們只是感情好矫夷,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,650評(píng)論 6 386
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著憋槐,像睡著了一般双藕。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上阳仔,一...
    開封第一講書人閱讀 49,850評(píng)論 1 290
  • 那天忧陪,我揣著相機(jī)與錄音,去河邊找鬼。 笑死嘶摊,一個(gè)胖子當(dāng)著我的面吹牛延蟹,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播叶堆,決...
    沈念sama閱讀 39,006評(píng)論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼阱飘,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了虱颗?” 一聲冷哼從身側(cè)響起沥匈,我...
    開封第一講書人閱讀 37,747評(píng)論 0 268
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎忘渔,沒想到半個(gè)月后高帖,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,207評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡畦粮,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,536評(píng)論 2 327
  • 正文 我和宋清朗相戀三年棋恼,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片锈玉。...
    茶點(diǎn)故事閱讀 38,683評(píng)論 1 341
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡爪飘,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出拉背,到底是詐尸還是另有隱情师崎,我是刑警寧澤,帶...
    沈念sama閱讀 34,342評(píng)論 4 330
  • 正文 年R本政府宣布椅棺,位于F島的核電站犁罩,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏两疚。R本人自食惡果不足惜床估,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,964評(píng)論 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望诱渤。 院中可真熱鬧丐巫,春花似錦、人聲如沸勺美。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,772評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽赡茸。三九已至缎脾,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間占卧,已是汗流浹背遗菠。 一陣腳步聲響...
    開封第一講書人閱讀 32,004評(píng)論 1 266
  • 我被黑心中介騙來泰國(guó)打工联喘, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人辙纬。 一個(gè)月前我還...
    沈念sama閱讀 46,401評(píng)論 2 360
  • 正文 我出身青樓耸袜,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親牲平。 傳聞我的和親對(duì)象是個(gè)殘疾皇子堤框,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,566評(píng)論 2 349

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