Markdown語法簡要說明

Markdown語法

注意Markdown中使用到的語法符號(hào)均為英文符號(hào)

Markdown語法主要分為如下幾大部分:
標(biāo)題,段落,區(qū)塊引用,強(qiáng)調(diào),列表分割線,鏈接圖片,反斜杠符號(hào)等。


一、 標(biāo)題

標(biāo)題有兩種形式:
第一種:使用=-來標(biāo)記一級標(biāo)題和二級標(biāo)題

一級標(biāo)題
=======

二級標(biāo)題
-------

效果如下:

一級標(biāo)題

二級標(biāo)題

第二種:使用#可以表示1~6級標(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)題

二、 段落

一個(gè)Markdown段落是由一個(gè)或者多個(gè)連續(xù)的文本行組成,段落的前后需要有一個(gè)以上的空行(空行的定義是該行只包含空格和制表符)。Markdown允許段落內(nèi)強(qiáng)制換行,方式是使用兩個(gè)以上的空格再加上回車。


三、 區(qū)塊引用

在段落的每一行使用符號(hào)>來表示該段落是區(qū)塊引用,區(qū)塊引用可以嵌套。
例子:

>區(qū)塊引用
>>嵌套引用

效果如下:

區(qū)塊引用

嵌套引用

PS:可以多層嵌套,類似標(biāo)題的語法,通過添加>的個(gè)數(shù)來進(jìn)行多層嵌套,例如三層嵌套使用:>>>


四、代碼區(qū)塊

要在Markdown中建立代碼區(qū)塊,只需要縮進(jìn)4個(gè)空格或者一個(gè)制表符。
或者將代碼放在 ``` 符號(hào)劃分的區(qū)域內(nèi)。```后面的單詞表示區(qū)塊內(nèi)的代碼是哪種語言
例:使用 ```

```javascript
console.log("代碼區(qū)塊");
```

效果:

console.log("代碼區(qū)塊");

五、強(qiáng)調(diào)

Markdown使用星號(hào)(*)或者下劃線(_)來標(biāo)記強(qiáng)調(diào)的符號(hào) ,一個(gè)符號(hào)表示斜體,兩個(gè)符號(hào)表示粗體。
例子:

*斜體*, *粗體*
_斜體_,_粗體_

效果:

斜體,粗體
斜體, 粗體

注意:標(biāo)記符號(hào)和文字之間不能有空格


六、列表

Markdown支持無序列表和有序列表
無序列表使用星號(hào)(*),加號(hào)(+)或者減號(hào)(-)來標(biāo)記
例子:

使用星號(hào)(*
* 第一項(xiàng)
* 第二項(xiàng)
* 第三項(xiàng)

使用加號(hào)(+
+ 第一項(xiàng)
+ 第二項(xiàng)
+ 第三項(xiàng)

使用減號(hào)(-
- 第一項(xiàng)
- 第二項(xiàng)
- 第三項(xiàng)

效果:

使用星號(hào)(*

  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)

使用加號(hào)(+

  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)

使用減號(hào)(-

  • 第一項(xiàng)
  • 第二項(xiàng)
  • 第三項(xiàng)

七、分隔線

在一行中使用三個(gè)以上的星號(hào)(*)、減號(hào)(-)或者下劃線(_)來建立一個(gè)分隔線,行內(nèi)不能有其他東西。
例子:

使用星號(hào)(*
***
使用減號(hào)(-
---
使用下劃線(_
___

效果:

使用星號(hào)(*


使用減號(hào)(-


使用下劃線(_



八、鏈接

Markdown支持兩種形式的鏈接語法: 行內(nèi)式參考式。
不管是哪一種方式,鏈接文字都是用[方括號(hào)]來標(biāo)記。

行內(nèi)式只需要在方括號(hào)后緊接著加上(圓括號(hào))并在圓括號(hào)內(nèi)插入鏈接即可,如果還想加上鏈接的title文字(title文字表示鼠標(biāo)懸浮在該鏈接上時(shí)顯示的提示文字),只要在鏈接后面,用雙引號(hào)把title文字包起來即可,鏈接和title文字之間需要使用空格來隔開,title文字是可選的。

參考式是在方括號(hào)后再接上另一個(gè)方括號(hào),在第二個(gè)方括號(hào)內(nèi)填入用于辨識(shí)鏈接的標(biāo)識(shí)。title文字和行內(nèi)式一致,選擇性地加在鏈接之后,用雙引號(hào)包裹起來。

例子:

行內(nèi)式:
[Markdown語法說明](http://www.appinn.com/markdown/ "title文字")

參考式:
[Markdown語法說明][id]
[id]:http://www.appinn.com/markdown/ "title文字"

效果:

行內(nèi)式:
Markdown語法說明(行內(nèi)式)

參考式(有些工具可能未實(shí)現(xiàn),推薦使用行內(nèi)式):
[Markdown語法說明(參考式)][id]
[id]:http://www.appinn.com/markdown/ "title文字"


九、圖片

圖片的使用方式和鏈接的使用方式類似,只是需要在第一個(gè)方括號(hào)前加上!,里面的文字替換為圖片的描述文字,圖片也支持行內(nèi)式參考式兩種方式。
例子:

行內(nèi)式:
![圖片描述文字](https://s4.music.126.net/style/web2/img/default/default_album.jpg "title文字")

參考式(有些工具可能未實(shí)現(xiàn),推薦使用行內(nèi)式):
![圖片描述文字][id]
[id]:https://s4.music.126.net/style/web2/img/default/default_album.jpg "title文字"

效果:

行內(nèi)式:

圖片描述文字

參考式(有些工具可能未實(shí)現(xiàn),推薦使用行內(nèi)式):
![圖片描述文字][id]
[id]:https://s4.music.126.net/style/web2/img/default/default_album.jpg "title文字"


十、反斜杠

反斜杠的作用是轉(zhuǎn)義,轉(zhuǎn)義是指讓特殊符號(hào)表示其原本的意思,成為不具有Markdown語法的普通符號(hào)。
Markdown使用了一些特殊符號(hào)來定義一些文字的格式,例如斜體或粗體,我們使用*號(hào)來標(biāo)記,但是當(dāng)我們需要在頁面上呈現(xiàn)星號(hào)(*)而不使用它在Markdown中的語法時(shí),需要在星號(hào)(*)前加上反斜杠(\),形如:\*。
Markdown支持以下符號(hào)在前面加上反斜杠來幫助插入普通符號(hào):

\ 反斜杠 \
` 反引號(hào) \`
* 星號(hào) \*
_ 下劃線 \_
{} 花括號(hào) \{}
[] 方括號(hào) \[]
() 圓括號(hào) \()
# 井號(hào) \#
+ 加號(hào) \+
- 減號(hào) \-
. 英文句點(diǎn) \.
! 感嘆號(hào) \!


十一、反引號(hào) `

反引號(hào)起到標(biāo)記作用。
例如:

`標(biāo)記`

效果:

標(biāo)記


十二、復(fù)選框

復(fù)選框包含選中和未選中兩種形式。復(fù)選框使用減號(hào)(-)后緊接一個(gè)方括號(hào)([])來表示。減號(hào)和方括號(hào)之間有一個(gè)空格,方括號(hào)內(nèi)加上小寫英文字母(x)來表示選中的復(fù)選框,方括號(hào)內(nèi)加上一個(gè)空格表示未選中的復(fù)選框。
例:

選中:
- [x] 選中的復(fù)選框

未選中:
- [ ] 未選中的復(fù)選框

效果:

選中:

  • [x] 選中的復(fù)選框

未選中:

  • [ ] 未選中的復(fù)選框

十三、表格

使用markdown可以很容易地將數(shù)據(jù)進(jìn)行表格展示。表格的每一列使用|隔開,表頭(header)和內(nèi)容之間使用---來分隔。
例:

header 1 | header 2 | header 3
---|---|---
row 1 col 1 | row 1 col 2 | row 1 col 3
row 2 col 1 | row 2 col 2 | row 2 col 3

header 1 header 2 header 3
row 1 col 1 row 1 col 2 row 1 col 3
row 2 col 1 row 2 col 2 row 2 col 3

效果如下:

header 1 header 2 header 3
row 1 col 1 row 1 col 2 row 1 col 3
row 2 col 1 row 2 col 2 row 2 col 3

Markdown還可實(shí)現(xiàn)流程圖、甘特圖、數(shù)學(xué)公式等,由于這些功能使用較少,就沒一一列舉,可以參考文末的參考文檔,里面有更詳盡的介紹。


參考文檔鏈接:
Markdown 語法說明(簡體中文版)
有道云筆記Markdown指南


PS:對于前端程序員推薦一款將Markdown的Text文本的字符串轉(zhuǎn)為Html的工具:showdown
附上該工具的在線預(yù)覽地址:Showdown Live Editor
以及github所使用的Markdown的樣式:GitHub Markdown style

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

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

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