Markdown介紹

Markdown是一種純文本格式的標記語言，通過簡單的標記語法，使普通文本具有一定格式；
Markdown目標實作【易讀易寫】；成為適用于網路的書寫語言；

Markdown兼容HTML

Markdown并非取代HTML，他的語法很少，只對應 HTML 標記的一小部分，
Markdown 的構想不是要使得 HTML 檔案更容易書寫，在我看來，HTML 已經很容易寫了，Markdown 的理念是，能讓檔案更容易讀、寫和隨意改，HTML 是一種發布的格式，Markdown 是一種書寫的格式，就這樣，Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍，
在md檔案中，可直接使用HTML語法，不需要額外標注HTML還是Markdown語法；
html的塊級元素，div、p等；必須在前后加上空行與其他內容隔開
摘自W3Cschool
https://www.w3cschool.cn/Markdownyfsm/cfl1dz.html

如下：可直接撰寫html

span、a、img這樣的行內元素可以在md檔案中隨意使用，按照個人習慣，甚至可以不用Markdown語言，如果比較喜歡 HTML 的 a或img標簽，可以直接使用這些標簽，而不用 Markdown 提供的鏈接或是影像標簽語法

Markdown常用html標簽例子

所有html標簽都非常Nice，這里我只標出自己最得意的

1、<kbd>標簽

kbd標簽在日常筆記中，用來標注按鈕類文字，效果杠杠的；

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

2、?：
如果要顯示?符號，那么就寫成&copy;

3、換行<br/>：
在檔案中，使用Markdown的區塊參考，可以使段落更加美觀，但在有一些特殊需要的地方，仍然需要換行，這時候使用html的br換行標簽最好不過；

標題

Markdown支持兩種標題的語法：
第一種是用=和-分別標記一級標題和二級標題，語法格式：

這是一個一級標題
==============

這是一個二級標題
--------------

任何數量的=和-都有效果，
顯示效果如下圖：

第二種是使用#來標記，在每行開始插入1~6個#，
分別表示1~6級標簽
語法格式：

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

顯示效果如下：

一級標題

二級標題

三級標題

四級標題

五級標題

六級標題

串列

Markdown支持有序串列和無序串列；

無序串列

使用*、+、-三個符合表示無序串列，三個符號含義相同用哪個都行，同一級別的串列項建議使用同一個符號，避免眼花繚亂；
無序串列無論使用那種符號，如果需要實作多級串列，只需要在選項前面加上四個空格或者制表符
寫法如下：

* 第一項
     * 第一項的子項
          * 第一項子項的子項
* 第二項
    * 第二項的子項
* 第三項

顯示效果：

• 第一項
  • 第一項的子項
    • 第一項子項的子項
• 第二項
  • 第二項的子項
• 第三項

有序串列

有序串列的語法格式為:s數字+英文的點'.'+空格+內容
并且數字的大小不需要擔心，串列序號根據第一個數字依次排列，所以除了第一項，其他項只需要隨便寫個數字就行，但是為了自己的維護和易讀性，建議按照正常操作撰寫，

語法格式：

1. aaaaaaaa
2. bbbbbbbb
3. cccccccc
4. dddddddd
8. eeeeeeee
323. gggggggg

顯示效果：

1. aaaaaaaa
2. bbbbbbbb
3. ;cccccccc
4. dddddddd
5. eeeeeeee
6. gggggggg

串列嵌套

有序串列和無序串列可以根據需要隨意交叉嵌套，只需要在每項前面加制表符或四個空格即可；
語法格式：

+ 無序串列第一項
    1. 有序串列1-1
          + 無序串列1-1-1
          + 無序串列1-1-2
+ 無序串列第二項
    + 無序串列2-1
    + 無序串列2-2
+ 無序串列第三項
    1. 有序串列3-1
    2. 有序串列3-1
    3. 有序串列3-3

顯示效果：

• 無序串列第一項
  1. 有序串列1-1
     • 無序串列1-1-1
     • 無序串列1-1-2
• 無序串列第二項
  • 無序串列2-1
  • 無序串列2-2
• 無序串列第三項
  1. 有序串列3-1
  2. 有序串列3-1
  3. 有序串列3-3

區塊參考

區塊參考是在段落開頭使用>符號,后面跟一個空格，然后書寫內容就會放在區塊顯示，
可以在每行前面都加上>符號，也可以只在第一行加上>符號，
(個人建議每行前面都加上，提高規范性)

基本格式

語法格式：

> 區塊內內容
> 區塊內容文字說明

顯示效果：

區塊內內容
區塊內容文字說明

嵌套串列

>- aaaaaaa
>- bbbbbb
>1. 第一項
>2. 第二項
>3. 第三項

顯示效果：

• aaaaaaa
• bbbbbb

1. 第一項
2. 第二項
3. 第三項

嵌套其他Markdown語法

>其他Markdown語法在區塊內都適用，
>比如：
>分割線：
>-------
>標題：
>### 標題

顯示效果：

其他Markdown語法在區塊內都適用，
比如：
分割線：

---

標題：

標題

多級區塊嵌套

同樣區塊也可以嵌套使用，根據 > 的數量決定嵌套級別，

語法格式：

 > 一層
 >> 二層
 >>> 三層
 >>>> 四層
 >>>>> 五層
 >>>>>> 六層
 >>>>>>> 七層
 >>>>>>>> 八層

顯示效果：

一層

二層

三層

四層

五層

六層

七層

八層

與無序串列配合使用

無序串列與區塊可以互相嵌套，巧妙地使用可以展現出不錯的樣式，

例如：

+ 我們坐著喝著啤酒，陽光灑在肩頭，覺得是個自由人
          > 肖申克的救贖
+ 人生就像一盒巧克力，你永遠不會知道下一塊將會是哪種
          > 阿甘正傳

顯示效果

• 我們坐著喝著啤酒，陽光灑在肩頭，覺得是個自由人

  肖申克的救贖

• 人生就像一盒巧克力，你永遠不會知道下一塊將會是哪種

  阿甘正傳

例如：

>電影名句
>   + 我們坐著喝著啤酒，陽光灑在肩頭，覺得是個自由人
>            > 肖申克的救贖
>   + 人生就像一盒巧克力，你永遠不會知道下一塊將會是哪種
>            > 阿甘正傳

顯示效果：

電影名句

• 我們坐著喝著啤酒，陽光灑在肩頭，覺得是個自由人

  肖申克的救贖

• 人生就像一盒巧克力，你永遠不會知道下一塊將會是哪種

  阿甘正傳

分割線

可以在一行中用三個以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西，你也可以在星號或是減號中間插入空格，下面每種寫法都可以建立分隔線：

- - -
* * *
_ _ _
顯示效果：

代碼

代碼區塊

在Markdown中建立代碼區塊只需要在代碼每行前面加1個制表符或4個空格即可，Markdown會自動顯示成代碼區塊，
例如：

普通的文本前面沒有制表符和空格；

? 下面都是在行首加上制表符的代碼行:

? 這是一個代碼區塊，
? <div >
? ? &copy; 2004 Foo Corporation
? </div>
? //代碼注釋，伊人夕岸

顯示效果：

普通的文本前面沒有制表符和空格；

下面都是在行首加上制表符的代碼行:

<div >
    &copy; 2004 Foo Corporation
</div>
//代碼注釋，伊人夕岸

行內代碼

要顯示一行代碼，或者在一行文字中加一小行代碼，可以用反引號 ` 吧代碼包起來.

語法格式：

我的代碼：`int[] a = new int[5] { 1,2,3,4,5}; `

顯示效果：
我的代碼： int[] a = new int[5] { 1,2,3,4,5};

代碼區塊2

可以在一段代碼的前后加上 ``` 包裹住代碼塊，并且可以指定語言；

語法格式：

```CSharp
int[] a = new int[5] { 1,2,3,4,5};
int[] b = new int[a.Length];
Array.Copy(a,0,b,0,2);
foreach (int c in b) {
Console.WriteLine(c);
}
```

顯示效果：

	int[] a = new int[5] { 1,2,3,4,5}; 
	int[] b = new int[a.Length];
	Array.Copy(a,0,b,0,2); 
	foreach (int c in b) {
		 Console.WriteLine(c); 
	}

鏈接

在方括號后面加上圓括號，方括號寫鏈接名字，圓括號寫鏈接地址，在圓括號里面的鏈接后面，用雙引號可以撰寫title文字（連接和title文字中間需要空格）
語法格式：

[鏈接](Http://www.xxxxx.com "第三方鏈接")

顯示效果：
鏈接

也可以直接用尖括號將鏈接括起來

圖片

圖片的語法格式與鏈接基本相同，只需要在最前面加上一個 ! 號，后面中括號放上圖片的替代文字，在跟一個圓括號里面放上圖片的地址，并且也可以像鏈接一樣，在圖片路徑后面加上title顯示文字，

語法格式:


顯示效果

在這里先不展示圖片了，因為實在找不出合適的圖片，老鐵們可自行測驗^_^

Markdown無法設定圖片的寬高格式，如果需要可以使用HTML的 img 標簽，

表格

Markdown使用管道符 | 來分割不同的單元格，使用 - 來分割表頭和其他行
語法格式

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

顯示效果：

設定表格單元格格式

:- 左對齊
:-: 居中
-: 右對齊

語法格式：

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

顯示效果：

其他格式語法

轉譯

在Markdown中的特殊語法符號，如果在使用中只想顯示他們本來的樣子，不想顯示轉譯后的樣子，這首只需要在符號前面加上反斜杠即可，
例如：

\[鏈接](WWW.xxx.com)

這樣就能顯示成本來樣子，不會編譯成鏈接，

字體

Markdown支持以下字體格式：

斜體粗體

在文字兩端加上不同數量的 * 或 _ 符號

語法格式：

*斜體文本*
_斜體文本_
**粗體文本**
__粗體文本__
***粗斜體文本***
___粗斜體文本___

顯示效果：

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

寫在最后

以上都是作者在學習程序中總結的內容，不代表全部Markdown語法檔案，在某些語法中也可能不是唯一的實作方法，歡迎老鐵們對檔案中的內容問題進行交流

個人交流QQ：1695690324
原創不易，轉載請注明出處