Markdown語法經(jīng)典寫作教程

1. `Markdown`簡介

1.1 介紹

Markdown 是一種輕量級標(biāo)記語言徽级，它允許人們使用易讀易寫的純文本格式編寫文檔。
Markdown 語言在 2004 由約翰·格魯伯（英語：John Gruber）創(chuàng)建闰集。
Markdown 編寫的文檔可以導(dǎo)出 HTML 、Word跨蟹、圖像熙尉、PDF、Epub 等多種格式的文檔毅戈。
Markdown編寫的文檔后綴為 .md, .markdown苹丸。

1.2 `Markdown` 應(yīng)用

Markdown 能被使用來撰寫電子書，如：Gitbook苇经。
當(dāng)前許多網(wǎng)站都廣泛使用 Markdown 來撰寫幫助文檔或是用于論壇上發(fā)表消息赘理。例如：GitHub、簡書塑陵、reddit感憾、Diaspora、Stack Exchange令花、OpenStreetMap 、SourceForge等凉倚。

目前主流編輯器：我推薦Typora 編輯器兼都，Typora 支持 MacOS 、Windows稽寒、Linux平臺(tái)扮碧，且包含多種主題，編輯后直接渲染出效果杏糙。支持導(dǎo)出HTML慎王、PDF、Word宏侍、圖片等多種類型文件赖淤。
Typora 官網(wǎng)：https://typora.io/

2.`Markdown`標(biāo)題

2.1使用 `=` 和`-`標(biāo)記一級和二級標(biāo)題

我展示的是GitArtOS一級標(biāo)題
======

效果：

我展示的是GitArtOS一級標(biāo)題

我展示的是GitArtOS二級標(biāo)題
-----------------

效果：

我展示的是GitArtOS二級標(biāo)題

2.2 使用`#`號標(biāo)記可表示 `1-6`級標(biāo)題，一級標(biāo)題對應(yīng)一個(gè) `#`號谅河，二級標(biāo)題對應(yīng)兩個(gè)`#` 號咱旱，以此`類推`。

# GitArtOS一級標(biāo)題
## GitArtOS二級標(biāo)題
### GitArtOS三級標(biāo)題
#### GitArtOS四級標(biāo)題
##### GitArtOS五級標(biāo)題
###### GitArtOS六級標(biāo)題

效果如下：

GitArtOS一級標(biāo)題

GitArtOS二級標(biāo)題

GitArtOS三級標(biāo)題

GitArtOS四級標(biāo)題

GitArtOS五級標(biāo)題

GitArtOS六級標(biāo)題

3.`Markdown` 段落

3.1`Markdown` 段落沒有特殊的格式绷耍，直接編寫文字就好吐限，段落的換行是使用`兩個(gè)以上`空格加上回車

wowoowoooowowoGitArtOS  
wwoowowowowowoGitArtOS

效果：
wowoowoooowowo
wwoowowowowowo

3.2 當(dāng)然也可以在段落后面使用一個(gè)空行來表示重新開始一個(gè)段落。

wowoowoooowowoGitArtOS

wwoowowowowowoGitArtOS

效果：
wowoowoooowowoGitArtOS

wwoowowowowowoGitArtOS

3.3 字體

Markdown 可以使用以下幾種字體：

*GitArtOS斜體文本*
_GitArtOS斜體文本_
**GitArtOS粗體文本**
__GitArtOS粗體文本__
***GitArtOS粗斜體文本***
___GitArtOS粗斜體文本___

效果：

GitArtOS斜體文本
GitArtOS斜體文本
GitArtOS粗體文本
GitArtOS粗體文本
GitArtOS粗斜體文本
GitArtOS粗斜體文本

3.4 分隔線

你可以在一行中用三個(gè)以上的星號褂始、減號诸典、底線來建立一個(gè)分隔線，行內(nèi)不能有其他東西崎苗。你也可以在星號或是減號中間插入空格狐粱。下面每種寫法都可以建立分隔線：

***
* * *
*****
- - -
----------

效果如下：

3.5 刪除線

如果段落上的文字要添加刪除線舀寓，只需要在文字的兩端加上兩個(gè)波浪線 ~~ 即可，實(shí)例如下：

GitArtOSGitArtOSGitArtOS.COM
GitArtOSGitArtOSGitArtOSGitArtOSGitArtOS.COM
~~GitArtOSGitArtOSGitArtOSGitArtOS.COM~~

效果：
GitArtOSGitArtOSGitArtOS.COM
GitArtOSGitArtOSGitArtOSGitArtOSGitArtOS.COM
~~GitArtOSGitArtOSGitArtOSGitArtOS.COM~~

3.6 下劃線

下劃線可以通過 HTML的  標(biāo)簽來實(shí)現(xiàn)：

<u>帶下劃線文本</u>

效果：

帶下劃線文本.png

3.7 腳注

腳注是對文本的補(bǔ)充說明脑奠。
Markdown 腳注的格式如下:

[^要注明的文本]

例如：

 創(chuàng)建腳注格式類似這樣: [^RUNOOB]基公。

[^RUNOOB]: GitArtOS

效果：

腳注.png

4.`Markdown` 列表

Markdown 支持有序列表和無序列表。

4.1 無序列表

無序列表使用星號(*)宋欺、加號(+)或是減號(-)作為列表標(biāo)記轰豆，這些標(biāo)記后面要添加一個(gè)空格，然后再填寫內(nèi)容：

* GitArtOS第一項(xiàng)
* GitArtOS第二項(xiàng)
* GitArtOS第三項(xiàng)

+ GitArtOS第一項(xiàng)
+ GitArtOS第二項(xiàng)
+ GitArtOS第三項(xiàng)


- GitArtOS第一項(xiàng)
- GitArtOS第二項(xiàng)
- GitArtOS第三項(xiàng)

顯示效果：

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

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

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

4.2 有序列表

使用數(shù)字并加上 . 號來表示齿诞，如：

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

顯示效果：

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

4.3 列表嵌套

列表嵌套只需在子列表中的選項(xiàng)前面添加四個(gè)空格即可：

1. 第一項(xiàng)：
    - 第一項(xiàng)嵌套的第一個(gè)元素
    - 第一項(xiàng)嵌套的第二個(gè)元素
2. 第二項(xiàng)：
    - 第二項(xiàng)嵌套的第一個(gè)元素
    - 第二項(xiàng)嵌套的第二個(gè)元素

顯示效果：

第一項(xiàng)：
- 第一項(xiàng)嵌套的第一個(gè)元素
- 第一項(xiàng)嵌套的第二個(gè)元素
第二項(xiàng)：
- 第二項(xiàng)嵌套的第一個(gè)元素
- 第二項(xiàng)嵌套的第二個(gè)元素

5.`Markdown` 區(qū)塊

5.1 區(qū)塊引用

Markdown 區(qū)塊引用是在段落開頭使用>符號酸休，然后后面緊跟一個(gè)空格符號：

> 區(qū)塊引用
> GitArtOS雜耍
> 學(xué)雜耍，我是認(rèn)真的

效果如下：

區(qū)塊引用
GitArtOS雜耍
學(xué)雜耍祷杈，我是認(rèn)真的

5.2 區(qū)塊嵌套

另外區(qū)塊是可以嵌套的斑司，一個(gè)> 符號是最外層，兩個(gè)> 符號是第一層嵌套但汞，以此類推：

> GitArtOS外套
> > GitArtOS內(nèi)衣嵌套
> > > GitArtOS內(nèi)褲嵌套
> > > > 你們真壞Ｋ薰巍！

效果：

GitArtOS外套

GitArtOS內(nèi)衣嵌套

GitArtOS內(nèi)褲嵌套

你們真壞Ｋ嚼佟僵缺！

5.3 區(qū)塊、列表正向雜交使用

區(qū)塊使用列表實(shí)例

> 區(qū)塊中使用列表
> 1. 第一項(xiàng)
> 2. 第二項(xiàng)
> + 第一項(xiàng)
> + 第二項(xiàng)
> + 第三項(xiàng)

顯示效果：

區(qū)塊中使用列表

第一項(xiàng)

第二項(xiàng)

第一項(xiàng)

第二項(xiàng)

第三項(xiàng)

5.4 區(qū)塊踩叭、列表反向雜交使用

列表中使用區(qū)塊：如果要在列表項(xiàng)目內(nèi)放進(jìn)區(qū)塊磕潮，那么就需要在 > 前添加四個(gè)空格的縮進(jìn)。列表中使用區(qū)塊實(shí)例如下：

* 第一項(xiàng)
    > GitArtOS學(xué)雜耍嗎容贝？
    > 學(xué)雜耍自脯，我是認(rèn)真的
* 第二項(xiàng)

顯示效果：

第一項(xiàng)

GitArtOS學(xué)雜耍嗎？
學(xué)雜耍斤富，我是認(rèn)真的
第二項(xiàng)

6. `Markdown`代碼---程序員環(huán)節(jié)了

6.2 簡單的

如果是段落上的一個(gè)函數(shù)或片段的代碼可以用反引號把它包起來（`）膏潮，例如：

`gitartos()` 函數(shù)

顯示效果：
gitartos() 函數(shù)

6.2 和編程語言相結(jié)合的

你也可以用``` 包裹一段代碼，并指定一種語言（也可以不指定）：

/```javascript
$(document).ready(function () {
    alert('RUNOOB');
});
```/

顯示效果（去掉上面的/）：

$(document).ready(function () {
    alert('RUNOOB');
});

7.`Markdown`鏈接

7.1 簡單鏈接

鏈接使用方法如下：

[鏈接名稱](鏈接地址)

或者

<鏈接地址>

舉個(gè)??：

這是一個(gè)鏈接 [Markdown雜耍教程](http://www.reibang.com/p/a41087cbe901)

顯示效果：

這是一個(gè)鏈接 Markdown雜耍教程

當(dāng)然你也可以直接使用鏈接地址：

<http://www.reibang.com/p/a41087cbe901>

顯示效果如下：

http://www.reibang.com/p/a41087cbe901

7.2 高級鏈接

我們可以通過變量來設(shè)置一個(gè)鏈接茂缚，變量賦值在文檔末尾進(jìn)行：

這個(gè)鏈接用 1 作為網(wǎng)址變量 [GitArtOS][1]
這個(gè)鏈接用 雜耍 作為網(wǎng)址變量 [GitArtOS][雜耍]
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）

  [1]: http://www.reibang.com/p/a41087cbe901
  [雜耍]: http://www.reibang.com/p/a41087cbe901

顯示效果：

這個(gè)鏈接用 1 作為網(wǎng)址變量 GitArtOS
這個(gè)鏈接用雜耍作為網(wǎng)址變量 GitArtOS
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）

8.`Markdown` 圖片

圖標(biāo)實(shí)例.jpg

Markdown 圖片語法格式如下：

[圖片上傳失敗...(image-a1511f-1613818429292)]

[圖片上傳失敗...(image-14ffcf-1613818429295)]

GitArtOS1

GitArtOS2

8.1 當(dāng)然戏罢，你也可以像網(wǎng)址那樣對圖片網(wǎng)址使用變量:

這個(gè)鏈接用 1 作為網(wǎng)址變量 [GitArtOS][1].
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）

[1]: https://upload-images.jianshu.io/upload_images/19168340-e112b50cf76f07af.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240

這個(gè)鏈接用 1 作為網(wǎng)址變量 GitArtOS.
然后在文檔的結(jié)尾為變量賦值（網(wǎng)址）

8.2 `Markdown`還沒有辦法指定圖片的高度與寬度，如果你需要的話脚囊，你可以使用普通的`<img>`標(biāo)簽龟糕。

<img src="https://upload-images.jianshu.io/upload_images/19168340-e112b50cf76f07af.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240" width="50%">

顯示結(jié)果如下：

width=50%.png

9. `Markdown` 表格

Markdown 制作表格使用 | 來分隔不同的單元格，使用-來分隔表頭和其他行悔耘。

語法格式如下：

|  表頭   | 表頭  |
|  ----  | ----  |
| 單元格  | 單元格 |
| 單元格  | 單元格 |

顯示效果：

表頭	表頭
單元格	單元格
單元格	單元格

9.1 對齊方式

我們可以設(shè)置表格的對齊方式：
-: 設(shè)置內(nèi)容和標(biāo)題欄居右對齊讲岁。
:- 設(shè)置內(nèi)容和標(biāo)題欄居左對齊。
:-: 設(shè)置內(nèi)容和標(biāo)題欄居中對齊。

舉個(gè)??：

| 左對齊 | 右對齊 | 居中對齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |

以上代碼顯示結(jié)果如下：

左對齊	右對齊	居中對齊
單元格	單元格	單元格
單元格	單元格	單元格

10.高級技巧

支持的HTML 元素不在 Markdown 涵蓋范圍之內(nèi)的標(biāo)簽缓艳，都可以直接在文檔里面用 HTML 撰寫校摩。目前支持的HTML 元素有：<kbd> 等，如：

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦

顯示效果：

重啟電腦20210220 18：46.png

10.1 轉(zhuǎn)義

Markdown 使用了很多特殊符號來表示特定的意義阶淘，如果需要顯示特定的符號則需要使用轉(zhuǎn)義字符衙吩，Markdown 使用反斜杠轉(zhuǎn)義特殊字符：

**文本加粗** 
\*\* 正常顯示星號 \*\*

顯示效果：

文本加粗
** 正常顯示星號 **

10.2 其他特殊符號

Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號：

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

10.3 公式

當(dāng)你需要在編輯器中插入數(shù)學(xué)公式時(shí)，可以使用兩個(gè)美元符 $$ 包裹 TeX 或 LaTeX格式的數(shù)學(xué)公式來實(shí)現(xiàn)溪窒。提交后坤塞，問答和文章頁會(huì)根據(jù)需要加載Mathjax 對數(shù)學(xué)公式進(jìn)行渲染。如：

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

輸出結(jié)果為：

數(shù)學(xué)公式20210220 18.51.30.png

雜耍搞完澈蚌，收藏起來摹芙，點(diǎn)贊關(guān)注我GitArtOS吧，終于湊足了10條宛瞄。

最后編輯于：2021.02.20 19:01:39

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者

人面猴
序言：七十年代末浮禾，一起剝皮案震驚了整個(gè)濱河市，隨后出現(xiàn)的幾起案子份汗，更是在濱河造成了極大的恐慌盈电，老刑警劉巖，帶你破解...
沈念sama閱讀 218,682評論 6贊 507
死咒
序言：濱河連續(xù)發(fā)生了三起死亡事件杯活，死亡現(xiàn)場離奇詭異挣轨，居然都是意外死亡，警方通過查閱死者的電腦和手機(jī)轩猩，發(fā)現(xiàn)死者居然都...
沈念sama閱讀 93,277評論 3贊 395
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進(jìn)店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來荡澎，“玉大人均践，你說我怎么就攤上這事∧︶＃” “怎么了彤委？”我有些...
開封第一講書人閱讀 165,083評論 0贊 355
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵，是天一觀的道長或衡。經(jīng)常有香客問我焦影，道長，這世上最難降的妖魔是什么封断？我笑而不...
開封第一講書人閱讀 58,763評論 1贊 295
?港島之戀（遺憾婚禮）
正文為了忘掉前任斯辰，我火速辦了婚禮，結(jié)果婚禮上坡疼，老公的妹妹穿的比我還像新娘彬呻。我一直安慰自己，他們只是感情好，可當(dāng)我...
茶點(diǎn)故事閱讀 67,785評論 6贊 392
惡毒庶女頂嫁案：這布局不是一般人想出來的
文/花漫我一把揭開白布闸氮。她就那樣靜靜地躺著剪况，像睡著了一般。火紅的嫁衣襯著肌膚如雪蒲跨。梳的紋絲不亂的頭發(fā)上译断，一...
開封第一講書人閱讀 51,624評論 1贊 305
城市分裂傳說
那天，我揣著相機(jī)與錄音或悲，去河邊找鬼孙咪。笑死，一個(gè)胖子當(dāng)著我的面吹牛隆箩，可吹牛的內(nèi)容都是我干的该贾。我是一名探鬼主播，決...
沈念sama閱讀 40,358評論 3贊 418
雙鴛鴦連環(huán)套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開眼捌臊，長吁一口氣：“原來是場噩夢啊……” “哼杨蛋！你這毒婦竟也來了？” 一聲冷哼從身側(cè)響起理澎，我...
開封第一講書人閱讀 39,261評論 0贊 276
萬榮殺人案實(shí)錄
序言：老撾萬榮一對情侶失蹤逞力，失蹤者是張志新（化名）和其女友劉穎，沒想到半個(gè)月后糠爬，有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體寇荧，經(jīng)...
沈念sama閱讀 45,722評論 1贊 315
?護(hù)林員之死
正文獨(dú)居荒郊野嶺守林人離奇死亡，尸身上長有42處帶血的膿包…… 初始之章·張勛以下內(nèi)容為張勛視角年9月15日...
茶點(diǎn)故事閱讀 37,900評論 3贊 336
?白月光啟示錄
正文我和宋清朗相戀三年执隧，在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了揩抡。大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
茶點(diǎn)故事閱讀 40,030評論 1贊 350
活死人
序言：一個(gè)原本活蹦亂跳的男人離奇死亡镀琉，死狀恐怖峦嗤，靈堂內(nèi)的尸體忽然破棺而出，到底是詐尸還是另有隱情屋摔，我是刑警寧澤烁设，帶...
沈念sama閱讀 35,737評論 5贊 346
?日本核電站爆炸內(nèi)幕
正文年R本政府宣布，位于F島的核電站钓试，受9級特大地震影響装黑，放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜弓熏，卻給世界環(huán)境...
茶點(diǎn)故事閱讀 41,360評論 3贊 330
男人毒藥：我在死后第九天來索命
文/蒙蒙一恋谭、第九天我趴在偏房一處隱蔽的房頂上張望。院中可真熱鬧硝烂，春花似錦箕别、人聲如沸铜幽。這莊子的主人今日做“春日...
開封第一講書人閱讀 31,941評論 0贊 22
一樁弒父案串稀，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽除抛。三九已至，卻和暖如春母截，著一層夾襖步出監(jiān)牢的瞬間到忽，已是汗流浹背。一陣腳步聲響...
開封第一講書人閱讀 33,057評論 1贊 270
情欲美人皮
我被黑心中介騙來泰國打工清寇，沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留喘漏，地道東北人。一個(gè)月前我還...
沈念sama閱讀 48,237評論 3贊 371
代替公主和親
正文我出身青樓华烟，卻偏偏與公主長得像翩迈，于是被迫代替她去往敵國和親。傳聞我的和親對象是個(gè)殘疾皇子盔夜，可洞房花燭夜當(dāng)晚...
茶點(diǎn)故事閱讀 44,976評論 2贊 355

Markdown語法經(jīng)典寫作教程

1. Markdown簡介

1.1 介紹

1.2 Markdown 應(yīng)用

2.Markdown標(biāo)題

2.1使用 = 和-標(biāo)記一級和二級標(biāo)題

我展示的是GitArtOS一級標(biāo)題

我展示的是GitArtOS二級標(biāo)題

2.2 使用#號標(biāo)記 可表示 1-6級標(biāo)題，一級標(biāo)題對應(yīng)一個(gè) #號谅河，二級標(biāo)題對應(yīng)兩個(gè)# 號咱旱，以此類推。

GitArtOS一級標(biāo)題

GitArtOS二級標(biāo)題

GitArtOS三級標(biāo)題

GitArtOS四級標(biāo)題

GitArtOS五級標(biāo)題

GitArtOS六級標(biāo)題

3.Markdown 段落

3.1Markdown 段落沒有特殊的格式绷耍，直接編寫文字就好吐限，段落的換行是使用兩個(gè)以上空格加上回車

3.2 當(dāng)然也可以在段落后面使用一個(gè)空行來表示重新開始一個(gè)段落。

3.3 字體

3.4 分隔線

3.5 刪除線

3.6 下劃線

3.7 腳注

4.Markdown 列表

4.1 無序列表

4.2 有序列表

4.3 列表嵌套

5.Markdown 區(qū)塊

5.1 區(qū)塊引用

5.2 區(qū)塊嵌套

5.3 區(qū)塊、列表正向雜交使用

5.4 區(qū)塊踩叭、列表反向雜交使用

6. Markdown代碼---程序員環(huán)節(jié)了

6.2 簡單的

6.2 和編程語言相結(jié)合的

7.Markdown鏈接

7.1 簡單鏈接

7.2 高級鏈接

8.Markdown 圖片

8.1 當(dāng)然戏罢，你也可以像網(wǎng)址那樣對圖片網(wǎng)址使用變量:

8.2 Markdown還沒有辦法指定圖片的高度與寬度，如果你需要的話脚囊，你可以使用普通的<img>標(biāo)簽龟糕。

9. Markdown 表格

9.1 對齊方式

10.高級技巧

10.1 轉(zhuǎn)義

10.2 其他特殊符號

10.3 公式

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

1. `Markdown`簡介

1.2 `Markdown` 應(yīng)用

2.`Markdown`標(biāo)題

2.1使用 `=` 和`-`標(biāo)記一級和二級標(biāo)題

2.2 使用`#`號標(biāo)記可表示 `1-6`級標(biāo)題，一級標(biāo)題對應(yīng)一個(gè) `#`號谅河，二級標(biāo)題對應(yīng)兩個(gè)`#` 號咱旱，以此`類推`。

3.`Markdown` 段落

3.1`Markdown` 段落沒有特殊的格式绷耍，直接編寫文字就好吐限，段落的換行是使用`兩個(gè)以上`空格加上回車

4.`Markdown` 列表

5.`Markdown` 區(qū)塊

6. `Markdown`代碼---程序員環(huán)節(jié)了

7.`Markdown`鏈接

8.`Markdown` 圖片

8.2 `Markdown`還沒有辦法指定圖片的高度與寬度，如果你需要的話脚囊，你可以使用普通的`<img>`標(biāo)簽龟糕。

9. `Markdown` 表格