本帖整理了MarkDown的入門學(xué)習(xí)筆記~

---

一.介紹

Markdown 是一種輕量級(jí)的「標(biāo)記語(yǔ)言」，它的優(yōu)點(diǎn)很多，目前也被越來(lái)越多的寫作愛(ài)好者，撰稿者廣泛使用。

諸如微信公眾平臺(tái)、CSDN博客、還有Typora中寫文檔的部分，均涉及到MD的功能~

它用簡(jiǎn)潔的語(yǔ)法代替排版，而不像一般我們用的字處理軟件 Word 或 Pages 有大量的排版、字體設(shè)置。它使我們專心于碼字，用「標(biāo)記」語(yǔ)法，來(lái)代替常見(jiàn)的排版格式。例如此文從內(nèi)容到格式，甚至插圖，鍵盤就可以通通搞定了。

支持 Markdown 語(yǔ)法的編輯器有很多，Markdown 從寫作到完成，導(dǎo)出格式隨心所欲，你可以導(dǎo)出 HTML 格式的文件用來(lái)網(wǎng)站發(fā)布，也可以十分方便的導(dǎo)出 PDF 格式。

使用 Markdown 的優(yōu)點(diǎn)

• 專注你的文字內(nèi)容而不是排版樣式，安心寫作
• 輕松的導(dǎo)出 HTML、PDF 和本身的 .md 文件
• 純文本內(nèi)容，兼容所有的文本編輯器與字處理軟件
• 隨時(shí)修改你的文章版本，不必像字處理軟件生成若干文件版本導(dǎo)致混亂
• 可讀、直觀、學(xué)習(xí)成本低

Markdown 旨在簡(jiǎn)潔、高效，也由于 Markdown 的易讀易寫，人們用不同的編程語(yǔ)言實(shí)現(xiàn)了多個(gè)版本的解析器和生成器。這就導(dǎo)致了目前不同的 Markdown 工具集成了不同的功能（基礎(chǔ)功能大致相同），例如流程圖與時(shí)序圖，復(fù)雜表格與復(fù)雜公式的呈現(xiàn)，比如 GFM Markdown 就支持使用?Mermaid?生成圖表和流程圖。

二.段落及強(qiáng)調(diào)

在 Markdown 中，段落是由一個(gè)以上相連接的行句組成，而一個(gè)以上的空行則會(huì)切分出不同的段落，一般的段落不需要用空白或換行縮排。（空行的定義是顯示上看起來(lái)像是空行，便會(huì)被視為空行。比如，若某一行只包含空白和 tab，則該行也會(huì)被視為空行）

Markdown 允許段落內(nèi)的強(qiáng)迫換行，這個(gè)特性和其他大部分的 text-to-HTML 格式不一樣，其它的格式會(huì)把每個(gè)換行都轉(zhuǎn)成?<br />?標(biāo)簽。

這也就意味著在 Markdown 中，如果需要把一段內(nèi)容當(dāng)做段落來(lái)顯示，則需要保證該段內(nèi)容上方及下方至少各有一個(gè)空行~

如下是MD中字體的幾種特殊樣式語(yǔ)法：

• 強(qiáng)調(diào)：Markdown 使用星號(hào)?*?和下劃線?-?作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào)。
• 斜體:在 Markdown 中，將內(nèi)容用?*?或?_?包裹起來(lái)

（用什么符號(hào)開(kāi)啟標(biāo)簽，就要用什么符號(hào)結(jié)束；*?和?_?兩邊都有空白的話，它們就只會(huì)被當(dāng)成普通的符號(hào)）

• 粗體：用兩個(gè)?*?或?_?包起來(lái)
• 刪除線：你還可以使用兩個(gè)?~?來(lái)給內(nèi)容加上~~刪除線~~

三.標(biāo)題

Markdown 支持兩種標(biāo)題的語(yǔ)法，Setext?和?atx?形式。

• Setext 形式標(biāo)題：Setext?形式是用底線的形式，利用?=?（一級(jí)標(biāo)題）和?-?（二級(jí)標(biāo)題）
• Atx 形式標(biāo)題：Atx?形式則是在行首插入 1 到 6 個(gè)?#（最多支持 6 級(jí)標(biāo)題） ，對(duì)應(yīng)到標(biāo)題 1 到 6 級(jí)

四.鏈接

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

• 行內(nèi)形式鏈接：行內(nèi)形式的鏈接是在方塊括號(hào)后面接括號(hào)并插入網(wǎng)址鏈接即可，如果你還想要加上鏈接的?alt?提示文字，只要在網(wǎng)址后面，用雙引號(hào)把?alt?文字包起來(lái)即可，其格式為?[內(nèi)容](http_url "alt?提示")
• 參考形式鏈接：參考形式的鏈接使用另外一個(gè)方括號(hào)接在鏈接文字的括號(hào)后面，而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)簽

（注意：在MD可以使用Html的多數(shù)標(biāo)簽）

五.圖片

Markdown 使用一種和鏈接很相似的語(yǔ)法來(lái)標(biāo)記圖片，同樣也允許兩種樣式： 行內(nèi)和參考

• 行內(nèi)形式圖片：行內(nèi)形式圖片的語(yǔ)法格式為![Alt text](/path/to/img.jpg "Optional title")
• 參考樣式圖片：的格式添加一個(gè)圖片，其結(jié)構(gòu)為?![內(nèi)容][1]?+?[1]: image_url "alt 提示"?的組合

六.列表

• 無(wú)序列表：無(wú)序列表使用?*?、?+?或是?-?作為列表標(biāo)記
• 有序列表：有序列表則使用數(shù)字接著一個(gè)英文句號(hào)
• 任務(wù)列表：任務(wù)列表的語(yǔ)法格式為?- [ ] todo，其中?[ ]?(帶空格的中括號(hào))表示未完成的任務(wù)，[x](帶字母x的中括號(hào)) 表示已經(jīng)完成的任務(wù)

七.分隔線及引用

你可以在一行中用三個(gè)或以上的*、-、_來(lái)創(chuàng)建一個(gè)分隔線，行內(nèi)不能有其他東西。你也可以在星號(hào)中間插入空白。

?

引用：Markdown 使用 email 形式的區(qū)塊引用，我們?cè)谝脙?nèi)容每行的最前面加上?>?，就可以在 Markdown 文檔中創(chuàng)建一個(gè)區(qū)塊引用

八.代碼塊

行內(nèi)代碼的格式很簡(jiǎn)單，只需要使用兩個(gè) ` 將代碼內(nèi)容包裹起來(lái)即可，還有其他幾種表達(dá)方式：

• 用兩個(gè) ` 將代碼內(nèi)容包裹起來(lái)就是一個(gè)行內(nèi)代碼
• 縮進(jìn) 4 個(gè)空白或是 1 個(gè) tab 可以創(chuàng)建一個(gè)縮進(jìn)代碼塊
• 在代碼塊的前后各使用三個(gè)反引號(hào)（ ``` ）把需要高亮顯示的代碼包裹起來(lái)，并在第一個(gè) ``` 的末尾標(biāo)識(shí)上語(yǔ)言類型就可以創(chuàng)建一個(gè)高亮代碼塊

九.表格?

在 Markdown 中創(chuàng)建表格的語(yǔ)法要求如下：

1. 第一行包含表頭，并用"豎線"（ | ）分隔
2. 第二行將標(biāo)題與單元格分開(kāi)，并且必須包含三個(gè)或更多破折號(hào)
3. 第三行以及隨后的任何行均包含單元格值

需要注意的是：

• 不能在 Markdown 中將單元格分隔成多行，它們必須保持為單行，如果需要，還可以使用 HTML?<br>標(biāo)記對(duì)內(nèi)容進(jìn)行強(qiáng)制換行
• 第二行單元長(zhǎng)短與標(biāo)題不需要保持一致，但必須用豎線（|）分隔
• 可以有空白的單元格