Markdown語(yǔ)法學(xué)習(xí)
目錄
Markdown簡(jiǎn)介
Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言，它允許人們使用易讀易寫(xiě)的純文本格式編寫(xiě)文檔，然后轉(zhuǎn)換成格式豐富的HTML頁(yè)面。 —— 維基百科
你現(xiàn)在讀的這些文字，就是使用簡(jiǎn)單的符號(hào)標(biāo)識(shí)不同的標(biāo)題，將某些文字標(biāo)記為粗體或者斜體，創(chuàng)建一個(gè)鏈接.
基本語(yǔ)法
標(biāo)題
\#號(hào)數(shù)量標(biāo)示標(biāo)題大小， \# 一號(hào)標(biāo)題 \## 二號(hào)標(biāo)題 \### 三號(hào)標(biāo)題 \#### 四號(hào)標(biāo)題 \##### 五號(hào)標(biāo)題 \###### 六號(hào)標(biāo)題
展示出來(lái)的樣式
一號(hào)標(biāo)題
二號(hào)標(biāo)題
三號(hào)標(biāo)題
四號(hào)標(biāo)題
五號(hào)標(biāo)題
六號(hào)標(biāo)題
分隔線
通過(guò)利用分隔線可以使內(nèi)容保持距離，使閱讀者更容易閱讀。
語(yǔ)法為***
注意：使用***,或---(三個(gè)減號(hào))，或___(三個(gè)下劃線)，均能實(shí)現(xiàn)此效果。
效果為下面這貨
強(qiáng)調(diào)
使用*加粗強(qiáng)調(diào)即可實(shí)現(xiàn)為包含內(nèi)容強(qiáng)調(diào)的效果
效果為加粗強(qiáng)調(diào)*
使用*斜體強(qiáng)調(diào)即可實(shí)現(xiàn)為包含內(nèi)容強(qiáng)調(diào)的效果
效果為斜體強(qiáng)調(diào)*
鏈接
語(yǔ)法[百度] (www.baidu.com)以此實(shí)現(xiàn)起鏈接的效果
效果為百度
另外鏈接部分可以改為文章內(nèi)的標(biāo)題，實(shí)現(xiàn)文內(nèi)的錨點(diǎn)鏈接
語(yǔ)法[基本語(yǔ)法] (#基本語(yǔ)法)
效果為基本語(yǔ)法
圖片
語(yǔ)法與鏈接很像，不過(guò)前面要加上一個(gè)!
語(yǔ)法! [圖片名] (圖片鏈接)
注意有的Markdown不支持本地文件上傳，需要圖片有網(wǎng)絡(luò)地址，不過(guò)「簡(jiǎn)書(shū)」上支持截圖直接上傳和拖動(dòng)直接上傳，很是方便。
列表
列表分有序列表和無(wú)序列表
有序的很簡(jiǎn)單啦
\1. 有序1
\2. 有序2
效果為
- 有序1
- 有序2
而無(wú)序的語(yǔ)法為
\ - 無(wú)序
\ * 無(wú)序
\ +無(wú)序
注意：使用-，*，+都可以實(shí)現(xiàn)無(wú)序的排列，且沒(méi)有先后順序之分。但無(wú)序有一種包含的關(guān)系，在Markdown的語(yǔ)法里最高級(jí)的無(wú)序是實(shí)體黑心圓，次一級(jí)是空心圓，再次一次是實(shí)體正方形。
另外有序列表和無(wú)序列表中間需要分隔，不然會(huì)出現(xiàn)一些排版上的錯(cuò)誤，大家可以動(dòng)手體驗(yàn)一下就明白我說(shuō)的是什么意思啦。
正常效果展示
- 無(wú)序
- 無(wú)序
- 無(wú)序
- 無(wú)序
表格
表格的語(yǔ)法在基本語(yǔ)法里麻煩一些，不過(guò)據(jù)粥粥實(shí)際使用來(lái)說(shuō)，用個(gè)兩三回就可以熟練掌握了，這里也會(huì)介紹的盡量仔細(xì)，方便其他讀者查看。
語(yǔ)法：
第一欄|表頭1|表頭2|表頭3|
第二欄|----|------|------| 注意：必須有第二欄\豎線的內(nèi)容列表才能顯示出來(lái)，如我們添加以下表格信息。
| 項(xiàng)目 | 價(jià)格 | 數(shù)量 |
| :--- | -----:| :---: |
| 電腦 |￥5600 | 5 |
| 手機(jī) |￥4300 | 12 |
| 冰箱 |￥3100 | 234 |
效果如下
| 項(xiàng)目 | 價(jià)格 | 數(shù)量 |
|---|---|---|
| 電腦 | ￥5600 | 5 |
| 手機(jī) | ￥4300 | 12 |
| iPad | ￥3100 | 234 |
補(bǔ)充：大家可能注意到第二欄中的\：，這貨就是用來(lái)做對(duì)齊用的，語(yǔ)法如下：
左對(duì)齊：:----
右對(duì)齊：----:
居中對(duì)齊：:----:
大家在實(shí)際使用中試一兩次很容易就明了啦。
引用
語(yǔ)法為>引用內(nèi)容
嵌套的語(yǔ)法為>>引用也可以嵌套
效果為
引用內(nèi)容
引用也可以嵌套呀
代碼塊
下面就是一堆代碼
若是一行的話，可以用`代碼內(nèi)容`
效果如
代碼內(nèi)容
若是太多的話，直接```代碼塊內(nèi)容```
效果如下
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
擴(kuò)展語(yǔ)法
復(fù)選框
使用 - [ ] 和 - [x] 語(yǔ)法可以創(chuàng)建復(fù)選框，實(shí)現(xiàn) todo-list 等功能。效果如：
- [x] 已完成事項(xiàng)
- [ ] 待辦事項(xiàng)1
- [ ] 待辦事項(xiàng)2
LaTeX 公式
可以創(chuàng)建行內(nèi)公式，例如 。或者塊級(jí)公式：
效果如
流程圖
流程圖和時(shí)序?qū)儆贛arkdown中的擴(kuò)展語(yǔ)法，因此在某些僅支持基本語(yǔ)法編輯器的頁(yè)面中可能無(wú)法顯示效果，大家可以換其他的試試，不過(guò)太嫌麻煩的話，用其他更專業(yè)的流程圖工具會(huì)更好表現(xiàn)一些，畢竟Md更適用于標(biāo)記文本信息，如果想查看實(shí)際效果，可以復(fù)制下面代碼到馬克飛象的在線編輯器中試一下。
這里主要補(bǔ)充一些粥粥搜集來(lái)的知識(shí)。
st=>start: Start|past:>http://www.google.com[]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes
or No?|approved:>http://www.baidu.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request
st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e
流程圖語(yǔ)法及解釋
語(yǔ)法如下
flow
st=>start: Start|past:>http://www.google.com[blank]
e=>end: End:>http://www.google.com
op1=>operation: My Operation|past
op2=>operation: Stuff|current
sub1=>subroutine: My Subroutine|invalid
cond=>condition: Yes
or No?|approved:>http://www.baidu.com
c2=>condition: Good idea|rejected
io=>inputoutput: catch something...|request
st->op1(right)->cond
cond(yes, right)->c2
cond(no)->sub1(left)->op1
c2(yes)->io->e
c2(no)->op2->e
流程圖的語(yǔ)法大體分為兩面，第一段用來(lái)定義元素，第二段用來(lái)連接元素
如tag=>type: content:>url
-
定義元素
tag是一個(gè)標(biāo)簽，在第二段連接元素時(shí)用
type是這個(gè)標(biāo)簽的類型，常見(jiàn)的類型有- start
- end
- operation
- subroutine
- condition
-inputoutput
condition就是流程圖的框里要寫(xiě)的內(nèi)容，中英文均可，但是type后的冒號(hào)和文本間一定要有個(gè)空格，不然會(huì)出問(wèn)題，url指向一個(gè)連接，與框框中的文本綁定。
連接元素
直接用->連接兩個(gè)元素，condition有yes和no兩個(gè)分支，因此要寫(xiě)成cond(yes) cond(no)
時(shí)序圖:
```sequence
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am fine, thanks!
效果如下
Alice->Bob: Hello Bob, how are you?
Note right of Bob: Bob thinks
Bob-->Alice: I am fine, thanks!
