Markdown語(yǔ)法:基礎(chǔ)編寫(xiě)方式

一姊舵、為什么使用Markdown?

使用Markdown的契機(jī)在于自己建立的blog網(wǎng)站寓落,在發(fā)布博文是不可能只是發(fā)布一段純粹的文本吧括丁,沒(méi)有樣式,沒(méi)有標(biāo)題伶选,這樣子會(huì)導(dǎo)致閱讀時(shí)比較困難史飞,因此使用Markdown就非常必要了尖昏。

Markdown正在成為一種流行的標(biāo)記語(yǔ)言,得益于它易寫(xiě)易讀的特性构资,在程序員這一群體中使用越來(lái)越廣泛

接下來(lái)簡(jiǎn)單講解一下Markdown的一些基本問(wèn)題抽诉,不深入探討Markdown的其他問(wèn)題,僅專(zhuān)注如何使用Markdown進(jìn)行文章編寫(xiě)吐绵。


二迹淌、Markdown是什么?

1己单、含義

Markdown是一種輕量級(jí)標(biāo)記語(yǔ)言唉窃,在編輯文本是通過(guò)在文本的前或后加入各種標(biāo)記,從而可以快速將輸入的文本內(nèi)容進(jìn)行排版的一種語(yǔ)言纹笼。

Markdown是一種文檔的格式纹份,文件后綴為.md,我們常用的word后綴為.doc``.docx

2廷痘、與常見(jiàn)的富文本編輯器區(qū)別

Markdown與常見(jiàn)的富文本編輯器(如word)的作用是一致的:二者都是通過(guò)對(duì)純文本進(jìn)行編輯蔓涧,從而使純文本呈現(xiàn)出不同的樣子(如:文字顏色、大小等)牍疏;這里的純文本是指用戶(hù)在編輯器輸入的一段沒(méi)有做過(guò)任何處理的文本數(shù)據(jù)

而兩者不同點(diǎn)在于:富文本編輯器通常在輸入文本之后通過(guò)點(diǎn)擊某一項(xiàng)功能來(lái)調(diào)整文本(如點(diǎn)擊字體大小功能改變字體大写浪瘛) ;Mardkown則是在輸入文本時(shí)通過(guò)在文本前后加入標(biāo)記來(lái)實(shí)現(xiàn)改變文本的樣式(如輸入 ### 標(biāo)題 這樣可以得到一個(gè)三級(jí)標(biāo)題)

3鳞陨、Markdown的優(yōu)勢(shì)

在使用富文本編輯器編輯文字是是兩個(gè)不同的動(dòng)作,通常輸入完文本再去找相應(yīng)的功能來(lái)調(diào)整文本樣式瞻惋,而且一般都是寫(xiě)完一段文本就會(huì)選擇去調(diào)整文本樣式厦滤,故而無(wú)法保持一個(gè)流暢的寫(xiě)作思路

而Markdown的優(yōu)勢(shì)則在于我們?cè)跁?shū)寫(xiě)過(guò)程中不用刻意停下調(diào)整樣式歼狼,注意力沒(méi)有受到影響掏导,故而能保持一個(gè)書(shū)寫(xiě)流暢的狀態(tài);這種方式就好比我們傳統(tǒng)的紙筆寫(xiě)作羽峰,注意力始終集中在文字上


三趟咆、Markdown工具推薦

在使用Markdown編寫(xiě)文檔之前,一件稱(chēng)手的編輯工具是必不可少的梅屉,我推薦的是Typora

[圖片上傳失敗...(image-579b5e-1659974940924)]

它同時(shí)可以支持Windows值纱、Linux和Mac

vsCode也是一款不錯(cuò)的編輯工具,vsCode提供編寫(xiě)跟預(yù)覽兩個(gè)窗口坯汤;而Typora則是編寫(xiě)跟預(yù)覽兩者的結(jié)合虐唠,在編寫(xiě)的同時(shí)即可直接顯示效果, 對(duì)于個(gè)人來(lái)說(shuō)更加符合所見(jiàn)即所得的Markdown理念

除此之外還有許多優(yōu)秀的編輯工具惰聂,這里不做過(guò)多介紹


四疆偿、如何使用Markdown?

1咱筛、標(biāo)題

使用`#`號(hào)加空格進(jìn)行標(biāo)記,一個(gè)`#`號(hào)代表一級(jí)杆故,兩個(gè)代表二級(jí)迅箩,以此類(lèi)推,`#號(hào)后面必須帶空格处铛,否則無(wú)效果`

# 我是一級(jí)標(biāo)題

## 我是二級(jí)標(biāo)題

### 我是三級(jí)標(biāo)題

#### 我是四級(jí)標(biāo)題

##### 我是五級(jí)標(biāo)題

###### 我是六級(jí)標(biāo)題

[圖片上傳失敗...(image-285e2f-1659974940924)]

2沙热、字體

使用一個(gè)`*`或者`_`號(hào)表示斜體文本;使用兩個(gè)`*`或者`_`號(hào)表示粗體文本罢缸;使用三個(gè)`*`或者`_`號(hào)表示粗斜體文本

*我是斜體文本*

_我是斜體文本_

**我是粗體文本**

__我是粗體文本__

***我是粗斜體文本***

___我是粗斜體文本___

效果如下:


我是斜體文本

我是斜體文本

我是粗體文本

我是粗體文本

我是粗斜體文本

我是粗斜體文本

3篙贸、分割線(xiàn)

使用連續(xù)三個(gè)的減號(hào)`---`、下劃線(xiàn)`___`或者星號(hào)`***`都可以實(shí)現(xiàn)下劃線(xiàn)效果枫疆,三種方式都必須有`至少三個(gè)符號(hào)`(即三個(gè)減號(hào)或三個(gè)星號(hào))

---

___

***

效果如下:




4爵川、刪除線(xiàn)

使用連續(xù)的兩個(gè)`~~`在文本的前后加入即可

~~我被刪除了~~

同時(shí)也可以搭配一些其他的標(biāo)記**~~我是被刪除的粗體文本~~**

或者~~**我是被刪除的粗體文本2**~~

效果如下:


我被刪除了

我是被刪除的粗體文本

我是被刪除的粗體文本2

5、下劃線(xiàn)

使用標(biāo)簽`<u></u>`實(shí)現(xiàn)下劃線(xiàn)

<u></u>

效果如下:


<u>我腳下有下劃線(xiàn)</u>

6息楔、腳注

使用`[^要注明的文本]`實(shí)現(xiàn)腳注寝贡,如下所示:首先定義腳注,其次在下方輸入腳注說(shuō)明

[^要注明的文本]

[^要注明的文本]:腳注本注

效果如下:


我后面的這個(gè)就是腳注[1]

7值依、列表

7.1圃泡、有序列表

使用“數(shù)字加. ”的方式組成(即1. ),.后面需要加空格再輸入文本愿险,一般第二項(xiàng)不用輸入颇蜡,直接回車(chē)即自動(dòng)出現(xiàn)第二項(xiàng),這個(gè)需要看編輯器是否支持辆亏。

1. 第一項(xiàng)

2. 第二項(xiàng)

3. 第三項(xiàng)

效果如下:


  1. 第一項(xiàng)
  2. 第二項(xiàng)
  3. 第三項(xiàng)

7.2风秤、無(wú)序列表

使用*、+或者-號(hào)都可以扮叨,符號(hào)后面需要加空格再輸入文本缤弦,一般第二項(xiàng)不用輸入,直接回車(chē)即自動(dòng)出現(xiàn)第二項(xiàng)彻磁,這個(gè)需要看編輯器是否支持碍沐。

* 第一項(xiàng)

* 第二項(xiàng)

+ 第一項(xiàng)

+ 第二項(xiàng)

- 第一項(xiàng)

- 第二項(xiàng)

三者效果均如下:

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

只需在第一項(xiàng)下面鍵入一個(gè)制表(即table)然后輸入任意的*、+或者-號(hào)都可以實(shí)現(xiàn)(有些編輯器在鍵入制表之后會(huì)自動(dòng)生成二級(jí)三級(jí)列表)衷蜓,三級(jí)列表以此類(lèi)推

二級(jí)列表效果如下:


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

三級(jí)列表效果如下:


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

7.3累提、有序與無(wú)序結(jié)合

1. 第一項(xiàng):

- 第一項(xiàng)第一個(gè)

- 第一項(xiàng)第二個(gè)

2. 第二項(xiàng):

- 第二項(xiàng)第一個(gè)

- 第二項(xiàng)第二個(gè)

效果如下:


  1. 第一項(xiàng):
    • 第一項(xiàng)第一個(gè)
    • 第一項(xiàng)第二個(gè)
  2. 第二項(xiàng):
    • 第二項(xiàng)第一個(gè)
    • 第二項(xiàng)第二個(gè)

7.4、任務(wù)列表

使用*恍箭、+刻恭、-其中一個(gè)與[ ]組,*+鳍贾、-后面必須有空格倚评,[ ]中間必須有空格音半;在[]中間填入字母x可實(shí)現(xiàn)選中效果,也可以在效果出來(lái)后直接勾選進(jìn)行選中

* [ ] 測(cè)試*

+ [ ] 測(cè)試+

- [ ] 測(cè)試-

* [x] 測(cè)試選中

效果如下:


  • 測(cè)試*
  • 測(cè)試+
  • 測(cè)試-
  • 測(cè)試選中

8、區(qū)塊

8.1噪叙、單層區(qū)塊

使用>標(biāo)記抗俄,> 后面需要加空格巩踏,否則無(wú)效果

> 區(qū)塊

效果如下:

區(qū)塊


8.2腮介、多層區(qū)塊

只需在區(qū)塊里再使用>即可在區(qū)塊中再出現(xiàn)嵌套的區(qū)塊,可以嵌套多層區(qū)塊

多層區(qū)塊效果如下:

> 第一層區(qū)塊

`> 第二層區(qū)塊`

    `> 第三層區(qū)塊`

效果如下:

第一層區(qū)塊

第二層區(qū)塊

第三層區(qū)塊

8.3斗埂、列表中使用區(qū)塊

只需在二級(jí)列表中輸入>即可符糊,這一塊區(qū)塊等級(jí)等同于一級(jí)列表,以此類(lèi)推出第二呛凶、三..級(jí)列表

* 一級(jí)列表第一項(xiàng)

`>一級(jí)列表第一項(xiàng)列表區(qū)塊第一行 `

`>一級(jí)列表第一項(xiàng)列表區(qū)塊第二行 `

* 一級(jí)列表第二項(xiàng)

效果如下:

  • 一級(jí)列表第一項(xiàng)

    一級(jí)列表第一項(xiàng)列表區(qū)塊第一行

    一級(jí)列表第一項(xiàng)列表區(qū)塊第二行

  • 一級(jí)列表第二項(xiàng)

    一級(jí)列表第二項(xiàng)列表區(qū)塊第一行

    • 二級(jí)列表第一項(xiàng)

      二級(jí)列表第一項(xiàng)列表區(qū)塊第一行

9男娄、代碼塊

使用`文本`號(hào)對(duì)需要高亮提示的文本或者函數(shù)進(jìn)行標(biāo)注,(這個(gè)看使用習(xí)慣)

`main()`函數(shù)

效果如下:


main()函數(shù)

注:高亮方式還有使用==文本==的形式實(shí)現(xiàn)漾稀,但個(gè)人感覺(jué)`文本`更好用模闲,文本更高亮。


使用` ````進(jìn)行標(biāo)記崭捍,輸入代碼語(yǔ)言回車(chē)即可創(chuàng)建屬于該語(yǔ)言的代碼塊

```java +回車(chē)

效果如下:



10尸折、鏈接

10.1、包裹型鏈接

使用<url> 的形式寫(xiě)入殷蛇,在某些編輯器下會(huì)有帶下劃線(xiàn)的效果实夹。

<http://www.gocit.cn>

效果如下:


http://www.gocit.cn

10.2、命名鏈接

使用[鏈接名稱(chēng)](url "可選備注")的形式寫(xiě)入晾咪,不直接顯示鏈接收擦,而是顯示鏈接名稱(chēng)。

[豬豬殺手的blog](www.gocit.cn)

效果如下:


豬豬殺手的blog

10.3谍倦、跳轉(zhuǎn)鏈接

使用[鏈接名稱(chēng)](#標(biāo)題名稱(chēng))的形式寫(xiě)入,標(biāo)題名稱(chēng)必須存在且名稱(chēng)前需要輸入#號(hào)泪勒,該鏈接可以直接在頁(yè)內(nèi)跳轉(zhuǎn)

標(biāo)題講解請(qǐng)見(jiàn)[標(biāo)題](#1昼蛀、標(biāo)題)

效果如下:


標(biāo)題講解請(qǐng)見(jiàn)標(biāo)題

10.4、高級(jí)鏈接

通過(guò)變量設(shè)置一個(gè)鏈接圆存,變量在鏈接后或者文章末尾賦值叼旋。

我是由變量設(shè)置的鏈接A[我的blog][A]

我是由變量設(shè)置的鏈接B[百度一下][B]

下面是變量的賦值(變量賦值在效果中不會(huì)顯示)

[A]:http://www.gocit.cn

[B]:http://www.baidu.com

效果如下:


我是由變量設(shè)置的鏈接A我的blog

我是由變量設(shè)置的鏈接B百度一下

下面是變量的賦值(變量賦值在效果中不會(huì)顯示)

11、圖片

使用[圖片上傳失敗...(image-c0c8db-1659974940924)]的方式插入圖片(可選標(biāo)題為鼠標(biāo)放置在圖片中不動(dòng)時(shí)的提示文字)沦辙,圖片插入的方式與鏈接 方式相似夫植,但前面多一個(gè)感嘆號(hào)

[圖片上傳失敗...(image-9dd5f2-1659974940924)]

[圖片上傳失敗...(image-ebe951-1659974940924)]

[圖片上傳失敗...(image-d83e-1659974940924)]

[圖片上傳失敗...(image-15b5eb-1659974940924)]

也可以使用網(wǎng)址的方式

[鏈接圖片示例][pic]

[pic]:http://qiniu.gocit.cn/Markdown%E8%AF%AD%E6%B3%95%E5%BC%80%E7%AF%87/Markdown_pic_3.png?imageslim

??:pic是對(duì)上面鏈接圖片示例的pic賦值,可以放在文章最下面;這里對(duì)鏈接的賦值不會(huì)在效果中顯示详民,只會(huì)顯示一個(gè)可點(diǎn)擊的鏈接圖片示例

效果如下:

鏈接圖片示例

12延欠、表格

使用|來(lái)分隔不同單元格,使用-來(lái)分隔表頭和數(shù)據(jù)行沈跨。

| 表頭列1 | 表頭列2 | 表頭列3 | | -----| ---- | ---- | | 一行一列 | 一行二列 | 一行三列 | | 二行一列 | 二行二列 | 二行三列 |

效果如下:


表頭列1 表頭列2 表頭列3
一行一列 一行二列 一行三列
二行一列 二行二列 二行三列

分別使用:-由捎、-::-:表示左對(duì)齊饿凛、右對(duì)齊狞玛、居中對(duì)齊

| 表頭列1 | 表頭列2 | 表頭列3 |
| :-----| ----: | :----: |
| 一行一列 | 一行二列 | 一行三列 |
| 二行一列 | 二行二列 | 二行三列 |

效果如下:

表頭列1 表頭列2 表頭列3
一行一列 一行二列 一行三列
二行一列 二行二列 二行三列

推薦使用Typora:在Typora中則不需要全部打出來(lái)、只需打出第一行表頭涧窒,便可以直接設(shè)置表格的對(duì)齊方式心肪、增加新的一行或一列

13、高級(jí)技巧

13.1纠吴、轉(zhuǎn)義符

使用\可以對(duì)符號(hào)進(jìn)行轉(zhuǎn)義

沒(méi)轉(zhuǎn)義效果:**我是沒(méi)轉(zhuǎn)義效果**

轉(zhuǎn)義效果:\*\*我是轉(zhuǎn)義效果\*\*

效果如下:


沒(méi)轉(zhuǎn)義效果:我是沒(méi)轉(zhuǎn)義效果

轉(zhuǎn)義效果:**我是轉(zhuǎn)義效果**

對(duì)**轉(zhuǎn)義后文本不加粗了硬鞍,顯示*號(hào),一些情況下我們需要這些符號(hào)顯示出來(lái)呜象,就需要使用到\進(jìn)行轉(zhuǎn)義

13.2膳凝、公式

使用$$公式$$進(jìn)行標(biāo)記便能顯示公式,推薦使用Typora恭陡,只需要輸入$$+回車(chē)就可以編寫(xiě)公式了

$$

a_n = a_1q^{n-1}= \frac {a_1}{q} \cdot q^n(n \in N^*) \\
其中前 n 項(xiàng)的和公式為:\\
S_n =
\begin{Bmatrix}
\frac {a_1 \cdot (1-q^n)}{1-q} &,q \neq 1 \\
na_1 &,q=1
\end{Bmatrix}

$$

效果如下:


a_n = a_1q^{n-1}= \frac {a_1}{q} \cdot q^n(n \in N^*) \\ 其中前 n 項(xiàng)的和公式為:\\ S_n = \begin{Bmatrix} \frac {a_1 \cdot (1-q^n)}{1-q} &,q \neq 1 \\ na_1 &,q=1 \end{Bmatrix}

$$
\begin{Bmatrix}
a & b \\
c & d
\end{Bmatrix}

$$

效果如下:


\begin{Bmatrix} a & b \\ c & d \end{Bmatrix}

$$
\begin{CD}
A @>a>> B \\
@VbVV @AAcA \\
C @= D
\end{CD}
$$

效果如下:


\begin{CD} A @>a>> B \\ @VbVV @AAcA \\ C @= D \end{CD}·

$$
H_2 + O_2 = H_2O
$$

效果如下:


H_2 + O_2 = H_2O

其中_標(biāo)出下標(biāo)蹬音,^標(biāo)出上標(biāo)

如:

H_2

X^2
H_2 \\ X^2

公式方面不做過(guò)多的解釋?zhuān)饕遣欢信d趣的可以自行查找這一方面的教程


借鑒鏈接

Markdown 完全入門(mén)(上)

Markdown 教程

Markdown 高級(jí)技巧

Markdown類(lèi)圖學(xué)習(xí)

Markdown mermaid種草(7)_ 狀態(tài)圖

mermaid 餅圖使用指南


  1. 腳注本注 ?

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末休玩,一起剝皮案震驚了整個(gè)濱河市著淆,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌拴疤,老刑警劉巖永部,帶你破解...
    沈念sama閱讀 206,126評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異呐矾,居然都是意外死亡苔埋,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門(mén)蜒犯,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)组橄,“玉大人,你說(shuō)我怎么就攤上這事罚随∮窆ぃ” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 152,445評(píng)論 0 341
  • 文/不壞的土叔 我叫張陵淘菩,是天一觀的道長(zhǎng)遵班。 經(jīng)常有香客問(wèn)我,道長(zhǎng),這世上最難降的妖魔是什么狭郑? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 55,185評(píng)論 1 278
  • 正文 為了忘掉前任腹暖,我火速辦了婚禮,結(jié)果婚禮上愿阐,老公的妹妹穿的比我還像新娘微服。我一直安慰自己,他們只是感情好缨历,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,178評(píng)論 5 371
  • 文/花漫 我一把揭開(kāi)白布以蕴。 她就那樣靜靜地躺著,像睡著了一般辛孵。 火紅的嫁衣襯著肌膚如雪丛肮。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 48,970評(píng)論 1 284
  • 那天魄缚,我揣著相機(jī)與錄音宝与,去河邊找鬼。 笑死冶匹,一個(gè)胖子當(dāng)著我的面吹牛习劫,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播嚼隘,決...
    沈念sama閱讀 38,276評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼诽里,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了飞蛹?” 一聲冷哼從身側(cè)響起谤狡,我...
    開(kāi)封第一講書(shū)人閱讀 36,927評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎卧檐,沒(méi)想到半個(gè)月后墓懂,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,400評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡霉囚,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,883評(píng)論 2 323
  • 正文 我和宋清朗相戀三年捕仔,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片盈罐。...
    茶點(diǎn)故事閱讀 37,997評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡逻澳,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出暖呕,到底是詐尸還是另有隱情,我是刑警寧澤苞氮,帶...
    沈念sama閱讀 33,646評(píng)論 4 322
  • 正文 年R本政府宣布湾揽,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏库物。R本人自食惡果不足惜霸旗,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,213評(píng)論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望戚揭。 院中可真熱鬧诱告,春花似錦、人聲如沸民晒。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,204評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)潜必。三九已至靴姿,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間磁滚,已是汗流浹背佛吓。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,423評(píng)論 1 260
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留垂攘,地道東北人维雇。 一個(gè)月前我還...
    沈念sama閱讀 45,423評(píng)論 2 352
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像晒他,于是被迫代替她去往敵國(guó)和親吱型。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,722評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容