.md即markdown文件的基本常用編寫語法(圖文并茂)

.md即markdown文件的基本常用編寫語法(圖文并茂)

序言:

很久沒有寫博客了戚长,感覺只要是不寫博客田藐,人就很變得很懶,學的知識點感覺還是記不住兑徘,漸漸地讓我明白刚盈,看的越多,懂的越少(你這話不是有毛病嗎挂脑?應該是看的越多藕漱,懂的越多才對),此話怎講崭闲,當你在茫茫的前端知識庫里面東看看肋联,西看看的時候,很快就被海量的知識給淹沒了刁俭,根本就不知道哪些是對的橄仍,哪些是錯的,感覺好像這個也懂了,那個也懂了侮繁,但是真正寫起來虑粥,腦子又一片空白,又好像什么都不懂宪哩,這種狀態(tài)時有發(fā)生娩贷,這就叫不懂裝懂,最根本的原因就是看的太多锁孟,寫的太少育勺,所以為了改掉這樣毛病,把被動學習變成主動學習罗岖,接下來的日子涧至,多寫寫,即使是寫一些學習工作中遇到的坑也是好的桑包,沒事翻出來看看南蓬,還可以加深印象,好了哑了,廢話到處赘方!

起因:

因為現在的前端基本上都用上了前端構建工具,那就難免要寫一些readme等等的說明性文件弱左,但是這樣的文件一般都是.md的文件窄陡,編寫的語法自然跟其他格式的文件有所區(qū)別,置于為什么要用這種格式的文件拆火,不要問我跳夭,我也不知道,大家都這么用们镜,跟著用就對了币叹,如果有大神知道的,不妨告知小弟模狭,本文也是我學習寫markdown文件的一個筆記吧颈抚,僅供參考!

正文:

1嚼鹉、標題的幾種寫法:

第一種:

前面帶#號贩汉,后面帶文字,分別表示h1-h6,上圖可以看出锚赤,只到h6匹舞,而且h1下面會有一條橫線,注意宴树,#號后面有空格

第二種:

這種方式好像只能表示一級和二級標題策菜,而且=和-的數量沒有限制晶疼,只要大于一個就行

第三種:

這里的標題支持h1-h6酒贬,為了減少篇幅又憨,我就偷個懶,只寫前面二個锭吨,這個比較好理解蠢莺,相當于標簽閉合,注意零如,標題與#號要有空格

那既然3種都可以使用躏将,可不可以混合使用呢?我試了一下考蕾,是可以的祸憋,但是為了讓頁面標簽的統(tǒng)一性,不建議混合使用肖卧,推薦使用第一種蚯窥,比較簡潔,全面

為了搞清楚原理塞帐,我特意在網上搜一下在線編寫markdown的工具拦赠,發(fā)現實際上是把這些標簽最后轉化為html標簽,如圖:

在線地址請看這里:?markdown在線編輯(只是想看看背后的轉換原理葵姥,沒有廣告之嫌)

2荷鼠、列表

我們都知道,列表分為有序列表和無序列表榔幸,下面直接展示2種列表的寫法:

可以看到允乐,無序列表可以用* , + 削咆, — 來創(chuàng)建喳篇,用在線編輯器看,實際上是轉換成了ul>li 态辛,所以使用哪個都可以麸澜,推薦使用*吧

有序列表就相對簡單一點,只有這一種方式奏黑,注意炊邦,數字后面的點只能是英文的點,特別注意熟史,有序列表的序號是根據第一行列表的數字順序來的馁害,比如說:

第一組本來是3 2 1 倒序,但是現實3 4 5 蹂匹,后面一組 序號是亂的碘菜, 但是還是顯示 3 4 5 ,這點必須注意了


3、區(qū)塊引用

比如說忍啸,你想對某個部分做的內容做一些說明或者引用某某的話等仰坦,可以用這個語句

無序列表下方的便是引用,可以有多種用途计雌,看你的需求了悄晃,用法就是在語句前面加一個 > ,注意是英文的那個右尖括號凿滤,注意空格

引用因為是一個區(qū)塊妈橄,理論上是應該什么內容都可以放,比如說:標題翁脆,列表眷蚓,引用等等,看看下圖:

將上面的代碼稍微改一下反番,全部加上引用標簽溪椎,就變成了一個大的引用,還有引用里面還有引用恬口,那引用嵌套引用還沒有別的寫法呢校读?

上圖可以看出,想要在上一次引用中嵌套一層引用祖能,只需多加一個>歉秫,理論上可以無限嵌套,我就不整那么多了养铸,注意:多層嵌套的>是不需要連續(xù)在一起的雁芙,只要在一行就可以了,中間允許有空格钞螟,但是為了好看兔甘,還是把排版搞好吧


4、華麗的分割線

分割線可以由* - _(星號鳞滨,減號洞焙,底線)這3個符號的至少3個符號表示,注意至少要3個拯啦,且不需要連續(xù)澡匪,有空格也可以

應該看得懂吧,但是為了代碼的排版好看褒链,你們自己定規(guī)則吧唁情,前面有用到星號,建議用減號


5甫匹、鏈接

支持2種鏈接方式:行內式和參數式甸鸟,不管是哪一種惦费,鏈接文字都是用 [方括號] 來標記。

上圖可知抢韭,行內式的鏈接格式是:鏈接的文字放在[]中薪贫,鏈接地址放在隨后的()中,舉一反三篮绰,經常出現的列表鏈接就應該這樣寫:

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

這是行內式的寫法贾漏,參數式的怎么寫:

這就好理解了,就是把鏈接當成參數藕筋,適合多出使用相同鏈接的場景纵散,注意參數的對應關系,參數定義時隐圾,這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"

其實還有一種隱式鏈接的寫法,但是我覺得那種寫法不直觀暇藏,所以就不寫了蜜笤,經常用的一般就上面2種,如果你想了解隱式鏈接盐碱,可以看我文章最后放出的參考地址


6把兔、圖片

圖片也有2種方式:行內式和參數式,

用法跟鏈接的基本一樣瓮顽,唯一的不同就是县好,圖片前面要寫一個!(這是必須的)暖混,沒什么好說的


7缕贡、代碼框

這個就比較重要了,很多時候都需要展示出一些代碼

如果代碼量比較少拣播,只有單行的話善绎,可以用單反引號包起來,如下:

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

多行用三個反引號禀酱,如果要寫注釋,可以在反引號后面寫

8牧嫉、表格

這個寫的有點麻煩剂跟,注意看

從這3種不同寫法看减途,表格的格式不一定要對的非常起,但是為了好看曹洽,對齊肯定是最好的鳍置,第一種的分割線后面的冒號表示對齊方式,寫在左邊表示左對齊送淆,右邊為右對齊税产,兩邊都寫表示居中,還是有點意思的偷崩,不過現實出來的結果是辟拷,表格外面并沒有線框包起來,不知道別人的怎么弄的


9阐斜、強調

一個星號或者是一個下劃線包起來衫冻,會轉換為傾斜,如果是2個谒出,會轉換為加粗

10隅俘、轉義

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

11笤喳、刪除線


常用的基本上就這些了为居,如果還有一些常用的,可以跟我留言杀狡,我補充上去颜骤,我覺得圖文并茂才是高效學習的正確姿勢,但愿為你的學習帶來幫助捣卤!

?著作權歸作者所有,轉載或內容合作請聯系作者
  • 序言:七十年代末忍抽,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子董朝,更是在濱河造成了極大的恐慌鸠项,老刑警劉巖,帶你破解...
    沈念sama閱讀 217,406評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件子姜,死亡現場離奇詭異祟绊,居然都是意外死亡,警方通過查閱死者的電腦和手機哥捕,發(fā)現死者居然都...
    沈念sama閱讀 92,732評論 3 393
  • 文/潘曉璐 我一進店門牧抽,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人遥赚,你說我怎么就攤上這事扬舒。” “怎么了凫佛?”我有些...
    開封第一講書人閱讀 163,711評論 0 353
  • 文/不壞的土叔 我叫張陵讲坎,是天一觀的道長孕惜。 經常有香客問我,道長晨炕,這世上最難降的妖魔是什么衫画? 我笑而不...
    開封第一講書人閱讀 58,380評論 1 293
  • 正文 為了忘掉前任,我火速辦了婚禮瓮栗,結果婚禮上削罩,老公的妹妹穿的比我還像新娘。我一直安慰自己费奸,他們只是感情好弥激,可當我...
    茶點故事閱讀 67,432評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著货邓,像睡著了一般秆撮。 火紅的嫁衣襯著肌膚如雪四濒。 梳的紋絲不亂的頭發(fā)上换况,一...
    開封第一講書人閱讀 51,301評論 1 301
  • 那天,我揣著相機與錄音盗蟆,去河邊找鬼戈二。 笑死,一個胖子當著我的面吹牛喳资,可吹牛的內容都是我干的觉吭。 我是一名探鬼主播,決...
    沈念sama閱讀 40,145評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼仆邓,長吁一口氣:“原來是場噩夢啊……” “哼鲜滩!你這毒婦竟也來了?” 一聲冷哼從身側響起节值,我...
    開封第一講書人閱讀 39,008評論 0 276
  • 序言:老撾萬榮一對情侶失蹤徙硅,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后搞疗,有當地人在樹林里發(fā)現了一具尸體嗓蘑,經...
    沈念sama閱讀 45,443評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,649評論 3 334
  • 正文 我和宋清朗相戀三年匿乃,在試婚紗的時候發(fā)現自己被綠了桩皿。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,795評論 1 347
  • 序言:一個原本活蹦亂跳的男人離奇死亡幢炸,死狀恐怖泄隔,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情宛徊,我是刑警寧澤梅尤,帶...
    沈念sama閱讀 35,501評論 5 345
  • 正文 年R本政府宣布柜思,位于F島的核電站,受9級特大地震影響巷燥,放射性物質發(fā)生泄漏赡盘。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,119評論 3 328
  • 文/蒙蒙 一缰揪、第九天 我趴在偏房一處隱蔽的房頂上張望陨享。 院中可真熱鬧,春花似錦钝腺、人聲如沸抛姑。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,731評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽定硝。三九已至,卻和暖如春毫目,著一層夾襖步出監(jiān)牢的瞬間蔬啡,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,865評論 1 269
  • 我被黑心中介騙來泰國打工镀虐, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留箱蟆,地道東北人。 一個月前我還...
    沈念sama閱讀 47,899評論 2 370
  • 正文 我出身青樓刮便,卻偏偏與公主長得像空猜,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子恨旱,可洞房花燭夜當晚...
    茶點故事閱讀 44,724評論 2 354

推薦閱讀更多精彩內容