Markdown語法學(xué)習(xí)
目錄
Markdown簡介
Markdown 是一種輕量級標(biāo)記語言,它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉(zhuǎn)換成格式豐富的HTML頁面。 —— 維基百科
你現(xiàn)在讀的這些文字,就是使用簡單的符號標(biāo)識不同的標(biāo)題,將某些文字標(biāo)記為粗體或者斜體,創(chuàng)建一個(gè)鏈接.
基本語法
標(biāo)題
\#號數(shù)量標(biāo)示標(biāo)題大小, \# 一號標(biāo)題 \## 二號標(biāo)題 \### 三號標(biāo)題 \#### 四號標(biāo)題 \##### 五號標(biāo)題 \###### 六號標(biāo)題
展示出來的樣式
一號標(biāo)題
二號標(biāo)題
三號標(biāo)題
四號標(biāo)題
五號標(biāo)題
六號標(biāo)題
分隔線
通過利用分隔線可以使內(nèi)容保持距離,使閱讀者更容易閱讀。
語法為***
注意:使用***,或---(三個(gè)減號),或___(三個(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)*
鏈接
語法[百度] (www.baidu.com)以此實(shí)現(xiàn)起鏈接的效果
效果為百度
另外鏈接部分可以改為文章內(nèi)的標(biāo)題,實(shí)現(xiàn)文內(nèi)的錨點(diǎn)鏈接
語法[基本語法] (#基本語法)
效果為基本語法
圖片
語法與鏈接很像,不過前面要加上一個(gè)!
語法! [圖片名] (圖片鏈接)
注意有的Markdown不支持本地文件上傳,需要圖片有網(wǎng)絡(luò)地址,不過「簡書」上支持截圖直接上傳和拖動(dòng)直接上傳,很是方便。
列表
列表分有序列表和無序列表
有序的很簡單啦
\1. 有序1
\2. 有序2
效果為
- 有序1
- 有序2
而無序的語法為
\ - 無序
\ * 無序
\ +無序
注意:使用-,*,+都可以實(shí)現(xiàn)無序的排列,且沒有先后順序之分。但無序有一種包含的關(guān)系,在Markdown的語法里最高級的無序是實(shí)體黑心圓,次一級是空心圓,再次一次是實(shí)體正方形。
另外有序列表和無序列表中間需要分隔,不然會出現(xiàn)一些排版上的錯(cuò)誤,大家可以動(dòng)手體驗(yàn)一下就明白我說的是什么意思啦。
正常效果展示
- 無序
- 無序
- 無序
- 無序
表格
表格的語法在基本語法里麻煩一些,不過據(jù)粥粥實(shí)際使用來說,用個(gè)兩三回就可以熟練掌握了,這里也會介紹的盡量仔細(xì),方便其他讀者查看。
語法:
第一欄|表頭1|表頭2|表頭3|
第二欄|----|------|------| 注意:必須有第二欄\豎線的內(nè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ǔ)充:大家可能注意到第二欄中的\:,這貨就是用來做對齊用的,語法如下:
左對齊::----
右對齊:----:
居中對齊::----:
大家在實(shí)際使用中試一兩次很容易就明了啦。
引用
語法為>引用內(nèi)容
嵌套的語法為>>引用也可以嵌套
效果為
引用內(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ò)展語法
復(fù)選框
使用 - [ ] 和 - [x] 語法可以創(chuàng)建復(fù)選框,實(shí)現(xiàn) todo-list 等功能。效果如:
- [x] 已完成事項(xiàng)
- [ ] 待辦事項(xiàng)1
- [ ] 待辦事項(xiàng)2
LaTeX 公式
可以創(chuàng)建行內(nèi)公式,例如 。或者塊級公式:
效果如
流程圖
流程圖和時(shí)序?qū)儆贛arkdown中的擴(kuò)展語法,因此在某些僅支持基本語法編輯器的頁面中可能無法顯示效果,大家可以換其他的試試,不過太嫌麻煩的話,用其他更專業(yè)的流程圖工具會更好表現(xiàn)一些,畢竟Md更適用于標(biāo)記文本信息,如果想查看實(shí)際效果,可以復(fù)制下面代碼到馬克飛象的在線編輯器中試一下。
這里主要補(bǔ)充一些粥粥搜集來的知識。
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
流程圖語法及解釋
語法如下
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
流程圖的語法大體分為兩面,第一段用來定義元素,第二段用來連接元素
如tag=>type: content:>url
-
定義元素
tag是一個(gè)標(biāo)簽,在第二段連接元素時(shí)用
type是這個(gè)標(biāo)簽的類型,常見的類型有- start
- end
- operation
- subroutine
- condition
-inputoutput
condition就是流程圖的框里要寫的內(nèi)容,中英文均可,但是type后的冒號和文本間一定要有個(gè)空格,不然會出問題,url指向一個(gè)連接,與框框中的文本綁定。
連接元素
直接用->連接兩個(gè)元素,condition有yes和no兩個(gè)分支,因此要寫成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!