工具集核心教程 | 第一篇： .md即markdown文件的基本經常使用編寫語法（圖文並茂）

序言:

---

感受只要是不寫博客，人就很變得很懶，學的知識點感受仍是記不住，漸漸地讓我明白，看的越多，懂的越少（你這話不是有毛病嗎？應該是看的越多，懂的越多才對），此話怎講，當你在茫茫的知識庫裏面東看看，西看看的時候，很快就被海量的知識給淹沒了，根本就不知道哪些是對的，哪些是錯的，感受好像這個也懂了，那個也懂了，可是真正寫起來，腦子又一片空白，又好像什麼都不懂，這種狀態時有發生，這就叫不懂裝懂，最根本的緣由就是看的太多，寫的太少，因此爲了改掉這樣毛病，把被動學習變成主動學習，接下來的日子，多寫寫，即便是寫一些學習工做中遇到的坑也是好的，沒事翻出來看看，還能夠加深印象，好了，廢話處處！

原由：

由於如今先後端、測試交互很頻繁，一個完整的項目或者教程，說明性文件必不可少！那就不免要寫一些readme等等的說明性文件，可是這樣的文件通常都是.md的文件，編寫的語法天然跟其餘格式的文件有所區別，置於爲何要用這種格式的文件，不要問我，我也不知道，你們都這麼用，跟着用就對了，若是有大神知道的，不妨告知小弟，本文也是我學習寫markdown文件的一個筆記吧，僅供參考！

正文：

1.標題的幾種寫法：

第一種：

前面帶#號，後面帶文字，分別表示h1-h6,上圖能夠看出，只到h6，並且h1下面會有一條橫線，注意，#號後面有空格

第二種：

這種方式好像只能表示一級和二級標題，並且=和-的數量沒有限制，只要大於一個就行

第三種：

這裏的標題支持h1-h6，爲了減小篇幅，我就偷個懶，只寫前面二個，這個比較好理解，至關於標籤閉合，注意，標題與#號要有空格

那既然3種均可以使用，可不能夠混合使用呢？我試了一下，是能夠的，可是爲了讓頁面標籤的統一性，不建議混合使用，推薦使用第一種，比較簡潔，全面

爲了搞清楚原理，我特地在網上搜一下在線編寫markdown的工具，發現其實是把這些標籤最後轉化爲html標籤，如圖：

在線地址請看這裏： markdown在線編輯 （只是想看看背後的轉換原理，沒有廣告之嫌）

2.列表

咱們都知道，列表分爲有序列表和無序列表，下面直接展現2種列表的寫法：

能夠看到，無序列表能夠用* ， + ， — 來建立，用在線編輯器看，其實是轉換成了ul>li ，因此使用哪一個均可以，推薦使用*吧

有序列表就相對簡單一點，只有這一種方式，注意，數字後面的點只能是英文的點，特別注意，有序列表的序號是根據第一行列表的數字順序來的，好比說：

第一組原本是3 2 1 倒序，可是現實3 4 5 ，後面一組 序號是亂的， 可是仍是顯示 3 4 5 ，這點必須注意了

3.區塊引用

好比說，你想對某個部分作的內容作一些說明或者引用某某的話等，能夠用這個語句

無序列表下方的即是引用，能夠有多種用途，看你的需求了，用法就是在語句前面加一個 > ，注意是英文的那個右尖括號，注意空格

引用由於是一個區塊，理論上是應該什麼內容均可以放，好比說：標題，列表，引用等等，看看下圖：

將上面的代碼稍微改一下，所有加上引用標籤，就變成了一個大的引用，還有引用裏面還有引用，那引用嵌套引用尚未別的寫法呢？

上圖能夠看出，想要在上一次引用中嵌套一層引用，只需多加一個>，理論上能夠無限嵌套，我就不整那麼多了，注意：多層嵌套的>是不須要連續在一塊兒的，只要在一行就能夠了，中間容許有空格，可是爲了好看，仍是把排版搞好吧

4.華麗的分割線

分割線能夠由* - _（星號，減號，底線）這3個符號的至少3個符號表示，注意至少要3個，且不須要連續，有空格也能夠

應該看得懂吧，可是爲了代碼的排版好看，大家本身定規則吧，前面有用到星號，建議用減號

5.連接

支持2種連接方式：行內式和參數式，不論是哪種，連接文字都是用 [方括號] 來標記。

上圖可知，行內式的連接格式是：連接的文字放在[]中，連接地址放在隨後的（）中，觸類旁通，常常出現的列表連接就應該這樣寫：

連接還能夠帶title屬性，好像也只能帶title，帶不了其餘屬性，注意，是連接地址後面空一格，而後用引號引發來

這是行內式的寫法，參數式的怎麼寫：

這就好理解了，就是把連接當成參數，適合多出使用相同連接的場景，注意參數的對應關係，參數定義時，這3種寫法均可以：

還支持這種寫法，若是你不想混淆的話：

其實還有一種隱式連接的寫法，可是我以爲那種寫法不直觀，因此就不寫了，常常用的通常就上面2種，若是你想了解隱式連接，能夠看我文章最後放出的參考地址

6.圖片

圖片也有2種方式：行內式和參數式，

用法跟連接的基本同樣，惟一的不一樣就是，圖片前面要寫一個！（這是必須的），沒什麼好說的

7.代碼框

這個就比較重要了，不少時候都須要展現出一些代碼

若是代碼量比較少，只有單行的話，能夠用單反引號包起來，以下：

要是多行這個就不行了，多行能夠用這個，也就是一對`：

多行用三個反引號，若是要寫註釋，能夠在反引號後面寫

8.表格

這個寫的有點麻煩，注意看

從這3種不一樣寫法看，表格的格式不必定要對的很是起，可是爲了好看，對齊確定是最好的，第一種的分割線後面的冒號表示對齊方式，寫在左邊表示左對齊，右邊爲右對齊，兩邊都寫表示居中，仍是有點意思的，不過現實出來的結果是，表格外面並無線框包起來，不知作別人的怎麼弄的

9.強調

一個星號或者是一個下劃線包起來，會轉換爲<em>傾斜，若是是2個，會轉換爲<strong>加粗

10.轉義

就不一一列舉了，基本上跟js轉義是同樣的

11.刪除線

經常使用的基本上就這些了，若是還有一些經常使用的，能夠跟我留言，我補充上去，我以爲圖文並茂纔是高效學習的正確姿式，希望爲你的學習帶來幫助！

最後推薦一款Window下markdown編輯器

typora很是好用的一款本地MD文件編輯器 ,中文版下載地址：typora下載
界面以下：

參考文獻：

http://www.appinn.com/markdown/

http://sspai.com/25137

寫在最後

歡迎關注、喜歡、和點贊後續將推出更多的工具集教程，敬請期待。
歡迎關注個人微信公衆號獲取更多更全的學習資源，視頻資料，技術乾貨！

公衆號回覆「學習」，拉你進程序員技術討論羣，乾貨資源第一時間分享。

公衆號回覆「視頻」，領取800GJava視頻學習資源。

公衆號回覆「全棧」，領取1T前端，Java，產品經理，微信小程序，Python等資源合集大放送。

公衆號回覆「慕課」，領取1T慕課實戰學習資源。

公衆號回覆「實戰」，領取750G項目實戰學習資源。

公衆號回覆「面試」，領取8G面試實戰學習資源。