一、前言

• 由於有些語法無法在部落格園展示，推薦使用Typora可全功能演示MarkDown語法。
  下載地址：https://www.typora.io/
  
• 推薦使用jupyter，使用方法：https://www.cnblogs.com/springsnow/p/12030654.html
• markdown數學公式大全，https://www.cnblogs.com/nickchen121/p/11746655.html

Markdown是一種可以使用普通文字編輯器編寫的標記語言，通過簡單的標記語法，它可以使普通文字內容具有一定的格式。    --摘自百度百科

沒想到一向不太靠譜的百度百科這次竟有了如此精闢的解釋。之前專案一直使用word撰寫文件，有比較大的弊病：

• 只能對純文字檔案進行版本控制，而word是二進位制格式
• 格式繁雜，經常需要中斷寫作來控制格式
• 程式碼與文件分離，給寫文件造成更大的阻力

而假如單純的使用txt，就沒有一點格式了，用html雖然既有格式又能加入版本控制，但是需要花費較多的時間在標籤上，而且標籤佔了文件的較大百分比，不易閱讀。

所以，最終的解決方案就是 **Markdown** ，作為一種輕量級的標記語言，能在非常短的時間內掌握。而且不僅可以用於寫文件，還可以寫部落格、寫簡書、做一些隨手筆記。Markdown檔案以.md結尾，可以匯出為html和PDF（需要使用的工具支援）。它是一種語法（個人認為是簡化版的html），但是和html不同的是，各種解析器對其會有不同的表現。比如我的IDEA Markdown外掛會把分割線顯示成一條細灰線，Cmd Markdown則是顯示一條虛線。所以建議保持使用一種Markdown工具和儘量使用標準語法。
 

二、Markdown基本語法

1、 標題

如果一段文字被定義為標題，只要在這段文字前加 # 號即可。總共六級標題，建議在井號後加一個空格，這是最標準的 Markdown 語法。

程式碼：

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 最小隻有六級標題

效果：

過於粗暴，不予以展示，你複製貼上即知曉！！！

2、換行符

在markdown中，回車表示換行，空行表示一個新段落。

dfasdfasdfs  adfsa   aa   adf 

新行
新行

新段落

效果

dfasdfasdfs adfsa aa adf
新行
新行

新段落

3、 粗體

用兩個 * 包含一段文字就是粗體的語法，用一個 * 包含一段文字就是斜體的語法。

程式碼：

**我被加粗了**

效果：

我被加粗了

4、斜體

*單個星號* 或者 _單下劃線_表示斜體

程式碼：

*我傾斜了*

效果：

我傾斜了

5、刪除線

~~刪除線~~

效果如下：

刪除線

6、 列表

列表的顯示只需要在文字前加上 - 或 * 即可變為無序列表，有序列表則直接在文字前加1. 2. 3. 符號要和文字之間加上一個字元的空格。

1、有序列表

程式碼：

1. one
2. two 
3. three

效果：

1. one
2. two
3. three

2、 無序列表

*符號可以替換為+或-。

程式碼：

* one
* two
* three

效果：

• one
• two
• three

7、 引用

如果你需要引用一小段別處的句子，那麼就要用引用的格式。（> + 空格 + 引用文字）

程式碼：

> hello markdown!

效果：

hello markdown!

程式碼：

> hello markdown!
>> hello markdown!

效果：

hello markdown!

hello markdown!

8、 特殊顯示（`式）

標記程式碼使用反引號，即在英文輸入法下，ESC鍵下面和1鍵左邊的符號——`

只需要用兩個 ` 把中間的程式碼包裹起來。

程式碼：

`print('hello nick')`

效果：

print('hello nick')

9、 程式碼區域（```式）

在'''和'''之間新增對應的程式碼。

程式碼：

```python
print('hello nick')
```

效果：

print('hello nick')

10、連結

用<括號括起來>, 把URL作為連結插入。

程式碼：

www.baidu.com>

https://www.baidu.com

11、連結（連結描述顯示）

[連結描述](連結地址)

程式碼：

[百度](https://www.baidu.com "alt描述資訊")

效果：

百度

12、圖片

插入連結與插入圖片的語法很像，區別在一個 !號。

程式碼：


效果：

13、圖片連結

程式碼：

[![百度logo](https://www.baidu.com/img/baidu_jgylogo3.gif '描述資訊')](http://www.baidu.com)

效果：

14、分割線

輸入***或--- 再按回車即可繪製一條水平線，如下：

程式碼：

---

效果：

15、表格

而且第二行必須得有，並且第二行的冒號代表對齊格式，分別為居中；右對齊；左對齊）

name | age | sex 
:-:|:-|-:
tony|20|男
lucy|18|女

效果：

16、表情符號:smile:

：smile ：​（注意為：是英文的冒號）

:smile:

17、特殊符號

用\來轉義，表示文字中的markdown符號

三、總結

以上所述就是Markdown的基本標籤，雖然不多，但是可以解決大部分情況。

可以用20%的標籤完成80%的效果

基礎markdown語法參考：https://www.appinn.com/markdown/

插入數學公式markdown語法參考：https://www.zybuluo.com/codeep/note/163962