《Markdown語法》簡明教程

Markdown語法學習


目錄


Markdown簡介

Markdown 是一種輕量級標記語言,它允許人們使用易讀易寫的純文本格式編寫文檔,然后轉(zhuǎn)換成格式豐富的HTML頁面。 —— 維基百科

你現(xiàn)在讀的這些文字,就是使用簡單的符號標識不同的標題,將某些文字標記為粗體或者斜體,創(chuàng)建一個鏈接.


基本語法

標題

\#號數(shù)量標示標題大小, \# 一號標題 \## 二號標題 \### 三號標題 \#### 四號標題 \##### 五號標題 \###### 六號標題

展示出來的樣式

一號標題

二號標題

三號標題

四號標題

五號標題
六號標題

分隔線

通過利用分隔線可以使內(nèi)容保持距離,使閱讀者更容易閱讀。
語法為***
注意:使用***,或---(三個減號),或___(三個下劃線),均能實現(xiàn)此效果。
效果為下面這貨


強調(diào)

使用*加粗強調(diào)即可實現(xiàn)為包含內(nèi)容強調(diào)的效果
效果為
加粗強調(diào)*
使用*斜體強調(diào)即可實現(xiàn)為包含內(nèi)容強調(diào)的效果
效果為
斜體強調(diào)*


鏈接

語法[百度] (www.baidu.com)以此實現(xiàn)起鏈接的效果
效果為百度
另外鏈接部分可以改為文章內(nèi)的標題,實現(xiàn)文內(nèi)的錨點鏈接
語法[基本語法] (#基本語法)
效果為基本語法


圖片

語法與鏈接很像,不過前面要加上一個!
語法! [圖片名] (圖片鏈接)
注意有的Markdown不支持本地文件上傳,需要圖片有網(wǎng)絡(luò)地址,不過「簡書」上支持截圖直接上傳和拖動直接上傳,很是方便。


列表

列表分有序列表和無序列表
有序的很簡單啦
\1. 有序1
\2. 有序2
效果為

  1. 有序1
  2. 有序2

而無序的語法為
\ - 無序
\ * 無序
\ +無序

注意:使用-,*,+都可以實現(xiàn)無序的排列,且沒有先后順序之分。但無序有一種包含的關(guān)系,在Markdown的語法里最高級的無序是實體黑心圓,次一級是空心圓,再次一次是實體正方形。
另外有序列表和無序列表中間需要分隔,不然會出現(xiàn)一些排版上的錯誤,大家可以動手體驗一下就明白我說的是什么意思啦。

正常效果展示

  • 無序
    • 無序
      • 無序

表格

表格的語法在基本語法里麻煩一些,不過據(jù)粥粥實際使用來說,用個兩三回就可以熟練掌握了,這里也會介紹的盡量仔細,方便其他讀者查看。
語法:
第一欄|表頭1|表頭2|表頭3|
第二欄|----|------|------| 注意:必須有第二欄\豎線的內(nèi)容列表才能顯示出來,如我們添加以下表格信息。

| 項目  |  價格 |  數(shù)量  |
| :--- | -----:| :---: |
| 電腦  |¥5600 |  5    |
| 手機  |¥4300 |  12   |
| 冰箱  |¥3100 | 234   |

效果如下

項目 價格 數(shù)量
電腦 ¥5600 5
手機 ¥4300 12
iPad ¥3100 234

補充:大家可能注意到第二欄中的\:,這貨就是用來做對齊用的,語法如下:
左對齊::----
右對齊:----:
居中對齊::----:
大家在實際使用中試一兩次很容易就明了啦。


引用

語法為>引用內(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'''

擴展語法


復(fù)選框

使用 - [ ]- [x] 語法可以創(chuàng)建復(fù)選框,實現(xiàn) todo-list 等功能。效果如:

  • [x] 已完成事項
  • [ ] 待辦事項1
  • [ ] 待辦事項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}


流程圖

流程圖和時序?qū)儆贛arkdown中的擴展語法,因此在某些僅支持基本語法編輯器的頁面中可能無法顯示效果,大家可以換其他的試試,不過太嫌麻煩的話,用其他更專業(yè)的流程圖工具會更好表現(xiàn)一些,畢竟Md更適用于標記文本信息,如果想查看實際效果,可以復(fù)制下面代碼到馬克飛象的在線編輯器中試一下。
這里主要補充一些粥粥搜集來的知識。

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是一個標簽,在第二段連接元素時用
    type是這個標簽的類型,常見的類型有

    • start
    • end
    • operation
    • subroutine
    • condition
      -inputoutput

    condition就是流程圖的框里要寫的內(nèi)容,中英文均可,但是type后的冒號和文本間一定要有個空格,不然會出問題,url指向一個連接,與框框中的文本綁定。

  • 連接元素
    直接用->連接兩個元素,condition有yes和no兩個分支,因此要寫成cond(yes) cond(no)


時序圖:

```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!

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

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

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

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