markdown 語法
Markdown 的語法全由一些符號所組成队魏,這些符號經(jīng)過精挑細(xì)選奥裸,其作用一目了然
兼容 HTML
在 HTML 區(qū)塊標(biāo)簽間的 Markdown 格式語法將不會被處理
例:
<p>歡迎使用Markdown 文檔格式編寫文檔娃磺!</p>
效果:
<p>歡迎使用Markdown 文檔格式編寫文檔蝉绷!</p>
1. 區(qū)塊元素
段落和換行
段落:
是由一個或多個連續(xù)的文本行組成亡哄,它的前后要有一個以上的空行枝缔。
空行的定義是顯示上看起來像是空的,便會被視為空行蚊惯。
比方說愿卸,若某一行只包含空格和制表符,則該行也會被視為空行
換行:
在插入處先按入兩個以上的空格然后回
例:
你好截型,中國擦酌!
這是一封來自大山的信!
效果:
你好菠劝,中國赊舶!
這是一封來自大山的信!
標(biāo)題
在行首插入 1 到 6 個 # 赶诊,對應(yīng)到標(biāo)題 1 到 6 階
例:
# 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)題
區(qū)塊引用 Blockquotes
行最前面加上 >
例:
> 今天天氣不錯笼平!
> > --左霄紅
效果:
今天天氣不錯!
--左霄紅
列表
無序列表使用星號舔痪、加號或是減號作為列表標(biāo)記
有序列表則使用數(shù)字接著一個英文句點(diǎn)
例:
* 北京
* 天津
* 山西
1. 北京
2. 上海
3. 廣州
效果:
- 北京
- 天津
- 山西
- 北京
- 上海
- 廣州
代碼區(qū)塊
行首縮進(jìn) 4 個空格或是 1 個制表符就可以建立代碼區(qū)塊
例:
這里是測試信息
效果:
這里是測試信息
分隔線
在一行中用三個以上的星號寓调、減號、底線來建立一個分隔線锄码,行內(nèi)不能有其他東西
例:
---
___
***
效果:
2. 區(qū)段元素
鏈接
只要在方塊括號后面緊接著圓括號并插入網(wǎng)址鏈接即可
例:
[百度](http://baidu.com)
> 君不見夺英,黃河之水天上來晌涕,奔流到海不復(fù)回。
————[李白](http://baike.baidu.com/link?url=s9TDLrw3cIwB4M_epaF9pFzpskmvBjTtdhHAT4yptDQJmKwvWg2pk60uXG1SbI_0VYuIFy5hx68B054vhYMEtcUD3C4filz8bL_9lJCVe4S)《將進(jìn)酒》
![李白](http://upload-images.jianshu.io/upload_images/2666050-f2e9ac135450b8cd.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
效果:
君不見痛悯,黃河之水天上來余黎,奔流到海不復(fù)回。
————李白《將進(jìn)酒》
強(qiáng)調(diào)
Markdown 使用星號( * )作為標(biāo)記強(qiáng)調(diào)字詞的符號
被一個 * 包圍的字詞會被轉(zhuǎn)成用 <em>
被兩個 * 包起來的話载萌,則會被轉(zhuǎn)成 <strong>
例:
*this is a test*
**你好惧财!中國**
效果:
this is a test
你好!中國
代碼
如果要標(biāo)記一小段行內(nèi)代碼扭仁,你可以用反引號把它包起來( `)
例:
`var_dump($name)`
效果:
var_dump($name)
如果要標(biāo)記大段多行代碼垮衷,你可以用三個反引號把它包起來( ``` )
例:
```
public function test()
{
echo __LINE__;
}
```
效果:
public function test()
{
echo __LINE__;
}
圖片
· 一個驚嘆號 !
· 接著一個方括號,里面放上圖片的替代文字 [文字]
· 接著一個圓括號乖坠,里面放上圖片的網(wǎng)址 (網(wǎng)址)
例:
![李白](http://upload-images.jianshu.io/upload_images/2666050-f2e9ac135450b8cd.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
效果:
表格
例:
| 列1 | 列2 | 列3 |
| --- | --: | :-: |
| 天津| 128 | 28 |
效果:
列1 | 列2 | 列3 |
---|---|---|
天津 | 128 | 28 |
3. 其它
自動鏈接
Markdown 支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱
只要是用尖括號包起來<>搀突, Markdown 就會自動把它轉(zhuǎn)成鏈接。
一般網(wǎng)址的鏈接文字就和鏈接地址一樣
例:
<http://baidu.com>
<feng7396553@163.com>
效果:
反斜杠
利用反斜杠來插入一些在語法中有其它意義的符號
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號:
\ 反斜線
` 反引號
* 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點(diǎn)
! 驚嘆號
例:
\# 中國
效果:
# 中國