序言:
很久沒有寫博客了,感覺只要是不寫博客,人就很變得很懶,學(xué)的知識點感覺還是記不住,漸漸地讓我明白,看的越多,懂的越少(你這話不是有毛病嗎?應(yīng)該是看的越多,懂的越多才對),此話怎講,當(dāng)你在茫茫的前端知識庫里面東看看,西看看的時候,很快就被海量的知識給淹沒了,根本就不知道哪些是對的,哪些是錯的,感覺好像這個也懂了,那個也懂了,但是真正寫起來,腦子又一片空白,又好像什么都不懂,這種狀態(tài)時有發(fā)生,這就叫不懂裝懂,最根本的原因就是看的太多,寫的太少,所以為了改掉這樣毛病,把被動學(xué)習(xí)變成主動學(xué)習(xí),接下來的日子,多寫寫,即使是寫一些學(xué)習(xí)工作中遇到的坑也是好的,沒事翻出來看看,還可以加深印象,好了,廢話到處!
起因:
因為現(xiàn)在的前端基本上都用上了前端構(gòu)建工具,那就難免要寫一些readme等等的說明性文件,但是這樣的文件一般都是.md的文件,編寫的語法自然跟其他格式的文件有所區(qū)別,置于為什么要用這種格式的文件,不要問我,我也不知道,大家都這么用,跟著用就對了,如果有大神知道的,不妨告知小弟,本文也是我學(xué)習(xí)寫markdown文件的一個筆記吧,僅供參考!
正文:
1、標(biāo)題的幾種寫法:
第一種:


前面帶#號,后面帶文字,分別表示h1-h6,上圖可以看出,只到h6,而且h1下面會有一條橫線,注意,#號后面有空格
第二種:


這種方式好像只能表示一級和二級標(biāo)題,而且=和-的數(shù)量沒有限制,只要大于一個就行
第三種:


這里的標(biāo)題支持h1-h6,為了減少篇幅,我就偷個懶,只寫前面二個,這個比較好理解,相當(dāng)于標(biāo)簽閉合,注意,標(biāo)題與#號要有空格
那既然3種都可以使用,可不可以混合使用呢?我試了一下,是可以的,但是為了讓頁面標(biāo)簽的統(tǒng)一性,不建議混合使用,推薦使用第一種,比較簡潔,全面
為了搞清楚原理,我特意在網(wǎng)上搜一下在線編寫markdown的工具,發(fā)現(xiàn)實際上是把這些標(biāo)簽最后轉(zhuǎn)化為html標(biāo)簽,如圖:

在線地址請看這里:?markdown在線編輯(只是想看看背后的轉(zhuǎn)換原理,沒有廣告之嫌)
2、列表
我們都知道,列表分為有序列表和無序列表,下面直接展示2種列表的寫法:


可以看到,無序列表可以用* , + , — 來創(chuàng)建,用在線編輯器看,實際上是轉(zhuǎn)換成了ul>li ,所以使用哪個都可以,推薦使用*吧


有序列表就相對簡單一點,只有這一種方式,注意,數(shù)字后面的點只能是英文的點,特別注意,有序列表的序號是根據(jù)第一行列表的數(shù)字順序來的,比如說:




第一組本來是3 2 1 倒序,但是現(xiàn)實3 4 5 ,后面一組 序號是亂的, 但是還是顯示 3 4 5 ,這點必須注意了
3、區(qū)塊引用
比如說,你想對某個部分做的內(nèi)容做一些說明或者引用某某的話等,可以用這個語句


無序列表下方的便是引用,可以有多種用途,看你的需求了,用法就是在語句前面加一個 > ,注意是英文的那個右尖括號,注意空格
引用因為是一個區(qū)塊,理論上是應(yīng)該什么內(nèi)容都可以放,比如說:標(biāo)題,列表,引用等等,看看下圖:


將上面的代碼稍微改一下,全部加上引用標(biāo)簽,就變成了一個大的引用,還有引用里面還有引用,那引用嵌套引用還沒有別的寫法呢?


上圖可以看出,想要在上一次引用中嵌套一層引用,只需多加一個>,理論上可以無限嵌套,我就不整那么多了,注意:多層嵌套的>是不需要連續(xù)在一起的,只要在一行就可以了,中間允許有空格,但是為了好看,還是把排版搞好吧
4、華麗的分割線
分割線可以由* - _(星號,減號,底線)這3個符號的至少3個符號表示,注意至少要3個,且不需要連續(xù),有空格也可以


應(yīng)該看得懂吧,但是為了代碼的排版好看,你們自己定規(guī)則吧,前面有用到星號,建議用減號
5、鏈接
支持2種鏈接方式:行內(nèi)式和參數(shù)式,不管是哪一種,鏈接文字都是用 [方括號] 來標(biāo)記。


上圖可知,行內(nèi)式的鏈接格式是:鏈接的文字放在[]中,鏈接地址放在隨后的()中,舉一反三,經(jīng)常出現(xiàn)的列表鏈接就應(yīng)該這樣寫:


鏈接還可以帶title屬性,好像也只能帶title,帶不了其他屬性,注意,是鏈接地址后面空一格,然后用引號引起來

這是行內(nèi)式的寫法,參數(shù)式的怎么寫:


這就好理解了,就是把鏈接當(dāng)成參數(shù),適合多出使用相同鏈接的場景,注意參數(shù)的對應(yīng)關(guān)系,參數(shù)定義時,這3種寫法都可以:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
還支持這種寫法,如果你不想混淆的話:
[foo]: "Optional Title Here"
其實還有一種隱式鏈接的寫法,但是我覺得那種寫法不直觀,所以就不寫了,經(jīng)常用的一般就上面2種,如果你想了解隱式鏈接,可以看我文章最后放出的參考地址
6、圖片
圖片也有2種方式:行內(nèi)式和參數(shù)式,


用法跟鏈接的基本一樣,唯一的不同就是,圖片前面要寫一個?。ㄟ@是必須的),沒什么好說的
7、代碼框
這個就比較重要了,很多時候都需要展示出一些代碼
如果代碼量比較少,只有單行的話,可以用單反引號包起來,如下:


要是多行這個就不行了,多行可以用這個:


多行用三個反引號,如果要寫注釋,可以在反引號后面寫
8、表格
這個寫的有點麻煩,注意看


從這3種不同寫法看,表格的格式不一定要對的非常起,但是為了好看,對齊肯定是最好的,第一種的分割線后面的冒號表示對齊方式,寫在左邊表示左對齊,右邊為右對齊,兩邊都寫表示居中,還是有點意思的,不過現(xiàn)實出來的結(jié)果是,表格外面并沒有線框包起來,不知道別人的怎么弄的
9、強調(diào)


一個星號或者是一個下劃線包起來,會轉(zhuǎn)換為傾斜,如果是2個,會轉(zhuǎn)換為加粗
10、轉(zhuǎn)義


就不一一列舉了,基本上跟js轉(zhuǎn)義是一樣的
11、刪除線


常用的基本上就這些了,如果還有一些常用的,可以跟我留言,我補充上去,我覺得圖文并茂才是高效學(xué)習(xí)的正確姿勢,但愿為你的學(xué)習(xí)帶來幫助!