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

轉(zhuǎn)載至 # 凌云之翼 https://www.cnblogs.com/liugang-vip/p/6337580.html

序言:

很久沒有寫博客了,感覺只要是不寫博客责球,人就很變得很懶,學(xué)的知識點(diǎn)感覺還是記不住滋尉,漸漸地讓我明白佳励,看的越多剃盾,懂的越少(你這話不是有毛病嗎?應(yīng)該是看的越多琉朽,懂的越多才對)毒租,此話怎講,當(dāng)你在茫茫的前端知識庫里面東看看箱叁,西看看的時候墅垮,很快就被海量的知識給淹沒了,根本就不知道哪些是對的耕漱,哪些是錯的算色,感覺好像這個也懂了,那個也懂了螟够,但是真正寫起來灾梦,腦子又一片空白峡钓,又好像什么都不懂,這種狀態(tài)時有發(fā)生若河,這就叫不懂裝懂能岩,最根本的原因就是看的太多,寫的太少牡肉,所以為了改掉這樣毛病捧灰,把被動學(xué)習(xí)變成主動學(xué)習(xí),接下來的日子统锤,多寫寫毛俏,即使是寫一些學(xué)習(xí)工作中遇到的坑也是好的,沒事翻出來看看饲窿,還可以加深印象煌寇,好了,廢話到處逾雄!

起因:

因?yàn)楝F(xiàn)在的前端基本上都用上了前端構(gòu)建工具阀溶,那就難免要寫一些readme等等的說明性文件,但是這樣的文件一般都是.md的文件鸦泳,編寫的語法自然跟其他格式的文件有所區(qū)別银锻,置于為什么要用這種格式的文件,不要問我做鹰,我也不知道击纬,大家都這么用,跟著用就對了钾麸,如果有大神知道的更振,不妨告知小弟,本文也是我學(xué)習(xí)寫markdown文件的一個筆記吧饭尝,僅供參考肯腕!

正文:

1、標(biāo)題的幾種寫法:

第一種:

image

前面帶#號钥平,后面帶文字实撒,分別表示h1-h6,上圖可以看出,只到h6涉瘾,而且h1下面會有一條橫線知态,注意,#號后面有空格

第二種:

image
![image](http://upload-images.jianshu.io/upload_images/8958489-6f877a1a463db901.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

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

第三種:

image
image

這里的標(biāo)題支持h1-h6,為了減少篇幅囚巴,我就偷個懶原在,只寫前面二個友扰,這個比較好理解,相當(dāng)于標(biāo)簽閉合庶柿,注意村怪,標(biāo)題與#號要有空格

那既然3種都可以使用,可不可以混合使用呢浮庐?我試了一下甚负,是可以的,但是為了讓頁面標(biāo)簽的統(tǒng)一性审残,不建議混合使用梭域,推薦使用第一種,比較簡潔搅轿,全面

為了搞清楚原理病涨,我特意在網(wǎng)上搜一下在線編寫markdown的工具,發(fā)現(xiàn)實(shí)際上是把這些標(biāo)簽最后轉(zhuǎn)化為html標(biāo)簽璧坟,如圖:

image

在線地址請看這里: markdown在線編輯 (只是想看看背后的轉(zhuǎn)換原理既穆,沒有廣告之嫌)

2、列表

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

image
image

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

image
![image](http://upload-images.jianshu.io/upload_images/8958489-97bd53e64cdfee07.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

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

image
image
image
image

第一組本來是3 2 1 倒序儿惫,但是現(xiàn)實(shí)3 4 5 ,后面一組 序號是亂的伸但, 但是還是顯示 3 4 5 肾请,這點(diǎn)必須注意了

3、區(qū)塊引用

比如說更胖,你想對某個部分做的內(nèi)容做一些說明或者引用某某的話等铛铁,可以用這個語句

image
image

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

引用因?yàn)槭且粋€區(qū)塊倍权,理論上是應(yīng)該什么內(nèi)容都可以放掷豺,比如說:標(biāo)題奴迅,列表板驳,引用等等掠哥,看看下圖:

image
image

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

image
![image](http://upload-images.jianshu.io/upload_images/8958489-bbdb0e0181e13d92.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

上圖可以看出廓奕,想要在上一次引用中嵌套一層引用抱婉,只需多加一個>,理論上可以無限嵌套桌粉,我就不整那么多了蒸绩,注意:多層嵌套的>是不需要連續(xù)在一起的,只要在一行就可以了铃肯,中間允許有空格患亿,但是為了好看,還是把排版搞好吧

4押逼、華麗的分割線

分割線可以由* - _(星號步藕,減號,底線)這3個符號的至少3個符號表示挑格,注意至少要3個咙冗,且不需要連續(xù),有空格也可以

image
image

應(yīng)該看得懂吧漂彤,但是為了代碼的排版好看雾消,你們自己定規(guī)則吧,前面有用到星號挫望,建議用減號

5立润、鏈接

支持2種鏈接方式:行內(nèi)式和參數(shù)式,不管是哪一種媳板,鏈接文字都是用 [方括號] 來標(biāo)記桑腮。

image
[圖片上傳中...(image-6f150d-1529027323641-19)] 

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

image
image

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

image

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

image
![image](http://upload-images.jianshu.io/upload_images/8958489-c36e6910a35ddd90.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

這就好理解了,就是把鏈接當(dāng)成參數(shù)乏冀,適合多出使用相同鏈接的場景蝶糯,注意參數(shù)的對應(yīng)關(guān)系辆沦,參數(shù)定義時,這3種寫法都可以:

還支持這種寫法肢扯,如果你不想混淆的話:

其實(shí)還有一種隱式鏈接的寫法妒茬,但是我覺得那種寫法不直觀,所以就不寫了蔚晨,經(jīng)常用的一般就上面2種铭腕,如果你想了解隱式鏈接,可以看我文章最后放出的參考地址

6累舷、圖片

圖片也有2種方式:行內(nèi)式和參數(shù)式笋粟,

image
image

用法跟鏈接的基本一樣析蝴,唯一的不同就是,圖片前面要寫一個3⑴巍(這是必須的)佑菩,沒什么好說的

7、代碼框

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

如果代碼量比較少蕾哟,只有單行的話,可以用單反引號包起來帘营,如下:

image

[圖片上傳中...(image-3c426-1529027323640-10)]

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

[圖片上傳中...(image-169a37-1529027323640-9)]

![image](http://upload-images.jianshu.io/upload_images/8958489-72e44506f79ecf47.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

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

8肠骆、表格

這個寫的有點(diǎn)麻煩,注意看

image
![image](http://upload-images.jianshu.io/upload_images/8958489-5d48c528eb46e9ef.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

從這3種不同寫法看郊艘,表格的格式不一定要對的非常起唯咬,但是為了好看胆胰,對齊肯定是最好的,第一種的分割線后面的冒號表示對齊方式瞎嬉,寫在左邊表示左對齊厚柳,右邊為右對齊,兩邊都寫表示居中便监,還是有點(diǎn)意思的,不過現(xiàn)實(shí)出來的結(jié)果是毁靶,表格外面并沒有線框包起來逊移,不知道別人的怎么弄的

9胳泉、強(qiáng)調(diào)

image
 ![image](http://upload-images.jianshu.io/upload_images/8958489-bbe66016c74eb603.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

一個星號或者是一個下劃線包起來,會轉(zhuǎn)換為<em>傾斜巷嚣,如果是2個钳吟,會轉(zhuǎn)換為<strong>加粗

10红且、轉(zhuǎn)義

image
 ![image](http://upload-images.jianshu.io/upload_images/8958489-6b5a16f8e3ba7f83.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240) 

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

11嗤放、刪除線

image
image

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

參考文獻(xiàn):

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

http://sspai.com/25137

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市橘原,隨后出現(xiàn)的幾起案子涡上,更是在濱河造成了極大的恐慌吩愧,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,729評論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件脐帝,死亡現(xiàn)場離奇詭異糖权,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)疚顷,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,226評論 3 399
  • 文/潘曉璐 我一進(jìn)店門腿堤,熙熙樓的掌柜王于貴愁眉苦臉地迎上來如暖,“玉大人,你說我怎么就攤上這事酗洒〖纤欤” “怎么了?”我有些...
    開封第一講書人閱讀 169,461評論 0 362
  • 文/不壞的土叔 我叫張陵,是天一觀的道長黔州。 經(jīng)常有香客問我,道長牲蜀,這世上最難降的妖魔是什么绅这? 我笑而不...
    開封第一講書人閱讀 60,135評論 1 300
  • 正文 為了忘掉前任,我火速辦了婚禮匆篓,結(jié)果婚禮上寇窑,老公的妹妹穿的比我還像新娘。我一直安慰自己窗市,他們只是感情好饮笛,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,130評論 6 398
  • 文/花漫 我一把揭開白布福青。 她就那樣靜靜地躺著,像睡著了一般二蓝。 火紅的嫁衣襯著肌膚如雪指厌。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,736評論 1 312
  • 那天鸥诽,我揣著相機(jī)與錄音牡借,去河邊找鬼袭异。 笑死,一個胖子當(dāng)著我的面吹牛碴里,可吹牛的內(nèi)容都是我干的上真。 我是一名探鬼主播,決...
    沈念sama閱讀 41,179評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼陵像,長吁一口氣:“原來是場噩夢啊……” “哼寇壳!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起图贸,我...
    開封第一講書人閱讀 40,124評論 0 277
  • 序言:老撾萬榮一對情侶失蹤冕广,失蹤者是張志新(化名)和其女友劉穎撒汉,沒想到半個月后涕滋,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,657評論 1 320
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡溯饵,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,723評論 3 342
  • 正文 我和宋清朗相戀三年丰刊,在試婚紗的時候發(fā)現(xiàn)自己被綠了增拥。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片掌栅。...
    茶點(diǎn)故事閱讀 40,872評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖澄耍,靈堂內(nèi)的尸體忽然破棺而出晌缘,到底是詐尸還是另有隱情,我是刑警寧澤铅搓,帶...
    沈念sama閱讀 36,533評論 5 351
  • 正文 年R本政府宣布星掰,位于F島的核電站,受9級特大地震影響怀偷,放射性物質(zhì)發(fā)生泄漏播玖。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,213評論 3 336
  • 文/蒙蒙 一维蒙、第九天 我趴在偏房一處隱蔽的房頂上張望果覆。 院中可真熱鬧局待,春花似錦、人聲如沸钳榨。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,700評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽愤钾。三九已至候醒,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間伙菊,已是汗流浹背敌土。 一陣腳步聲響...
    開封第一講書人閱讀 33,819評論 1 274
  • 我被黑心中介騙來泰國打工返干, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人财剖。 一個月前我還...
    沈念sama閱讀 49,304評論 3 379
  • 正文 我出身青樓躺坟,卻偏偏與公主長得像,于是被迫代替她去往敵國和親咪橙。 傳聞我的和親對象是個殘疾皇子美侦,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,876評論 2 361

推薦閱讀更多精彩內(nèi)容

  • 或許很多人跟我一樣 被人在心里刷著存在感 很幸運(yùn) 他們成功了 每天都想著關(guān)于他們的一切 那么那么小的一件事都會令你...
    我吞了一顆太陽6閱讀 322評論 0 1
  • 《琴瑟何來》 文/黎峰 琴瑟清音何以藏音榜, 更添絲竹自悠揚(yáng)赠叼。 世相浮燥亂雅樂违霞, 古器沉香正文王。 駐足必是癮君子买鸽, ...
    黎峰小峰峰閱讀 278評論 0 1