標(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
- 列表2
- 列表3
列表項(xiàng)目可以包含多個(gè)段落渗柿,每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符:
語法:
1. 列表1个盆,段落1
列表1,段落2
2. 列表2朵栖,段落1
效果:
-
列表1颊亮,段落1
列表1,段落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)題汤善。
- 這是第一行列表項(xiàng)。
- 這是第二行列表項(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)