《Markdown語法》簡明教程

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. 有序1
  2. 有序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)公式,例如 \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N。或者塊級公式:

效果如
x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a}


流程圖

流程圖和時(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!

注意:想了解更多,請查看流程圖語法以及時(shí)序圖語法。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容