本文轉(zhuǎn)自 https://nepton.github.io/blog/markdown/markdown-grammar
作者:nepton
本文采用 Creative Commons BY-NC-ND 許可協(xié)議,版權(quán)歸作者所有继谚。 歡迎轉(zhuǎn)載烈菌,但必須保留此段聲明且在文章頁面明顯位置給出原文連接,否則保留追究法律責(zé)任的權(quán)利花履。 感謝您的支持芽世,這是對我最大的鼓勵(lì)。
想5分鐘學(xué)會(huì)使用 Markdown 的標(biāo)記語法诡壁?集中你的注意力,往下看。如果你是一名技術(shù)工作者通铲,你會(huì)發(fā)現(xiàn) Markdown 的語法簡直是世界上最簡單的語法了。如果你是一名作家蔑鹦,擔(dān)心所謂的“標(biāo)記”語言?別擔(dān)心箕宙,我保證你5分鐘举反,就學(xué)會(huì)了。
語法主要分為字體控制:
粗體:使用 **
斜體:使用 _
標(biāo)題:使用 #
引用:使用 >
橫線: 使用 —
列表:使用 * 或者 1. 2. 3.
鏈接:使用
圖片:使用
段落:敲回車扒吁,或者敲空格
對于技術(shù)人員火鼻,你還需要引用代碼塊,
代碼塊: 使用 `
多行代碼塊: 使用 ```
沒有了雕崩,到此結(jié)束
當(dāng)然還有很多社區(qū)志愿者擴(kuò)展了這些符號魁索,例如繪制表格、刪除線盼铁、頁內(nèi)跳轉(zhuǎn)粗蔚、注釋等等,這些使用頻率較低饶火,我將在以后博文中講解鹏控。
粗體和斜體
我們首先學(xué)習(xí)文本格式中的兩個(gè)基本元素:粗體和斜體。
紅色內(nèi)容
您會(huì)注意到一些格式化的 紅色內(nèi)容肤寝,這些內(nèi)容是含有Markdown排版格式的內(nèi)容当辐,為了提醒您的注意,因此把這些文本標(biāo)記為紅色突出顯示鲤看,請注意這些內(nèi)容中非同尋常的符號與排版缘揪,Markdown 就是通過他們讓您的文章井井有條。
您在排版時(shí)候义桂,需要?jiǎng)?chuàng)建一個(gè)斜體找筝,怎么做呢?在 Markdown 中這很簡單慷吊,您只需要需要斜體化的文字兩側(cè)添加下劃線()或者星號(*)袖裕。 例如,你好_ 或者 你好 將變?yōu)樾斌w溉瓶。簡單吧急鳄,變?yōu)樾斌w就是這樣簡單。
如果要把文字變?yōu)榇煮w嚷闭,只需要在這些文字兩側(cè)添加雙星號(), 例如我非常喜歡**去吃海鮮攒岛!
當(dāng)然,你可以同時(shí)把文字變?yōu)?粗體 和 斜體胞锰,只需要把這些符號都加上灾锯! 比如:我周末要陪 孩子 去公園玩!通常嗅榕,先寫星號或下劃線的順序無關(guān)緊要顺饮。
標(biāo)題
我們來看看這個(gè)重量級的家伙——標(biāo)題吵聪。文章需要分章節(jié),在這時(shí)兼雄,標(biāo)題就可以大顯身手吟逝。他為每一章節(jié)的內(nèi)容取一個(gè)名字,醒目的顯示出以下內(nèi)容是什么赦肋。
標(biāo)題有六種類型块攒,從大到小分別為:
標(biāo)題示例
要在Markdown中創(chuàng)建標(biāo)題,請?jiān)跇?biāo)題內(nèi)容前添加一個(gè)井號(#)佃乘,一級標(biāo)題放一個(gè)井號(#)囱井,二級標(biāo)題放兩個(gè)井號(##),三級標(biāo)題放三個(gè)井號(###),以此類推趣避。
同時(shí)庞呕,標(biāo)題的內(nèi)容中可以增加星號或者下劃線更改標(biāo)題內(nèi)容的樣式。
引用
如果您要引用一段內(nèi)容程帕,或者如果您需要讀者特別關(guān)注一句話住练,那么使用Markdown的引用語法將非常有用。使用了引用的內(nèi)容愁拭,將會(huì)出現(xiàn)特別格式化的句子或段落讲逛,以引起讀者的注意。例如:
買好的敛苇,更要買的好妆绞。
要?jiǎng)?chuàng)建這樣一段引用塊顺呕,您只需要在這行話前枫攀,添加一個(gè)大于號(>)就行,例如上一句內(nèi)容 Markdown 語法如下:
買好的株茶,更要買的好来涨。
橫線
有時(shí)候您需要在文章中添加一條漂亮的橫線作為分隔,如果要繪制一條橫線启盛,只需要在單獨(dú)一行內(nèi)蹦掐,輸入三個(gè)相同的星號(***)、三個(gè)相同的減號(---)或者三個(gè)相同的下劃線(___)就行僵闯。
不過有一點(diǎn)需要注意卧抗,這一行不要再添加其他內(nèi)容。
列表
列表分為兩種鳖粟,一種是以一個(gè)“點(diǎn)”開頭的無順序列表社裆,另一種是以數(shù)字開頭的有序列表。
無順序列表在列表項(xiàng)的每一行開頭向图,添加一個(gè)星號(*)泳秀,加號(+)或者減號(-)标沪,例如:
理解風(fēng)險(xiǎn)
識別風(fēng)險(xiǎn)
控制風(fēng)險(xiǎn)
我們是這樣實(shí)現(xiàn)上邊這個(gè)列表的:
- 理解風(fēng)險(xiǎn)
- 識別風(fēng)險(xiǎn)
- 控制風(fēng)險(xiǎn)
如果要實(shí)現(xiàn)一個(gè)有序的列表,在每一行的開頭添加一個(gè)數(shù)字嗜傅,外加一個(gè)點(diǎn)(1.)即可金句,上邊這個(gè)無序列表經(jīng)過改造后,變成以下有序列表:
理解風(fēng)險(xiǎn)
識別風(fēng)險(xiǎn)
控制風(fēng)險(xiǎn)
實(shí)現(xiàn)的方法如下:
- 理解風(fēng)險(xiǎn)
- 識別風(fēng)險(xiǎn)
- 控制風(fēng)險(xiǎn)
如果要實(shí)現(xiàn)嵌套的列表吕嘀,嵌套的可以通過列表縮進(jìn)一些空格實(shí)現(xiàn)违寞,這里您要問了,你說的 “一些空格” 是多少呢偶房?”一些” 的數(shù)量要看情況坞靶,對于”1. “、”2. “蝴悉、”3. “ 的情況是3個(gè)空格彰阴,對于 “* “、”+ “ 的情況是2個(gè)空格拍冠,這里的原則是:使用空格縮進(jìn)后保證新行的起始于上一行的正文區(qū)域尿这,
indent_example
上面的例子中,”* 風(fēng)險(xiǎn)是什么”的星號對齊上一行的正文第一個(gè)字”理”庆杜,markdown則認(rèn)為這是一個(gè)新的縮進(jìn)射众,以此類推,您以后就能夠自由靈活的控制縮進(jìn)了晃财。
鏈接
如果您要?jiǎng)?chuàng)建一個(gè)鼠標(biāo)可以點(diǎn)擊的文字叨橱,用戶點(diǎn)擊后跳轉(zhuǎn)到另一個(gè)網(wǎng)址,您就要用到鏈接断盛。在Markdown中罗洗,鏈接非常簡單,最簡單的鏈接钢猛,就是直接把網(wǎng)址完整的粘貼到頁面中即可伙菜,例如:https://nepton.github.io,您點(diǎn)點(diǎn)看命迈,點(diǎn)擊以后贩绕,您的瀏覽器的頁面是不是就跳轉(zhuǎn)到我的首頁了。
您要說壶愤,很多人制作的鏈接不是這樣亂七八糟的英文字母淑倾,而是通俗易懂的網(wǎng)站名,沒關(guān)系征椒,哈哈娇哆,這么做,把您剛才輸入的網(wǎng)址用一對小括號括起來,在左括號的前邊迂尝,給這個(gè)網(wǎng)址取一個(gè)名字脱茉,再用中括號把這個(gè)名字也括起來,就大功告成垄开,做完后是這樣子的:[豆豆的故事](https://nepton.github.io)
琴许,您來點(diǎn)一下 豆豆的故事 試試看,是不是一樣的效果呀溉躲。
圖片
顯示圖片的原理跟顯示鏈接差不多榜田,因?yàn)閳D片本身也是一個(gè)鏈接嘛,所以格式幾乎一模一樣锻梳,區(qū)別僅僅在于箭券,在鏈接格式的最左邊,再加一個(gè)感嘆號(!)疑枯。
完整的格式是:[圖片上傳失敗...(image-351730-1549001279871)]
辩块。
我們馬上做一個(gè),我們給圖片取個(gè)名字叫”我的圖片”荆永,地址為:https://picsum.photos/500/300废亭, 這是一個(gè)專門提供圖片的網(wǎng)站,我們僅拿這個(gè)鏈接做測試具钥。好了豆村,完整的格式如下:
![我的圖片](http://upload-images.jianshu.io/upload_images/16134207-a444d2ef7198035b?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
看看效果是什么樣的,怎么樣骂删,是不是 Markdown 很簡單掌动。
我的圖片
段落
段落就是敲回車,讓兩段話之間空出一個(gè)空行宁玫。Markdown 會(huì)自動(dòng)的把內(nèi)容分割為兩端話粗恢,如果您敲了回車后,新段落前沒有單獨(dú)空一行撬统,就不算新分段适滓。您看下邊的例子:
從前,有個(gè)國王和王后恋追,他們很富有,簡直享有一切他們所希望的東西罚屋,只是沒有孩子苦囱。 王后為此日夜傷感,說:“我就像塊不長莊稼的地脾猛∷和”。
以上2行原文之間有一個(gè)回車分隔,但是新段落前沒有單獨(dú)空行羹铅,因此 Markdown 認(rèn)為自一段話蚀狰,顯示效果如下:
從前,有個(gè)國王和王后职员,他們很富有麻蹋,簡直享有一切他們所希望的東西,只是沒有孩子焊切。 王后為此日夜傷感扮授,說:“我就像塊不長莊稼的地∽ǚ荆”刹勃。
如果在兩行之間,插入一個(gè)空白行嚎尤,就成為了兩段話荔仁,您看,原文第二行現(xiàn)在是空白的一行芽死,此時(shí) Markdown則認(rèn)為這是兩段話咕晋。
從前,有個(gè)國王和王后收奔,他們很富有掌呜,簡直享有一切他們所希望的東西,只是沒有孩子坪哄。 王后為此日夜傷感质蕉,說:“我就像塊不長莊稼的地◆婕。”模暗。
以上內(nèi)容Markdown顯示的結(jié)果為:
從前,有個(gè)國王和王后念祭,他們很富有兑宇,簡直享有一切他們所希望的東西,只是沒有孩子粱坤。
王后為此日夜傷感隶糕,說:“我就像塊不長莊稼的地≌拘”枚驻。
有些時(shí)候,您要寫一首小詩株旷,都是一行一句的再登,但是又不想通過分段分隔,因?yàn)槟菢硬迦肟招泻螅信c行之間的間距很大锉矢,會(huì)很難看梯嗽,這時(shí)候要怎么辦呢?
如果是這樣的情況沽损,請保留小詩一行一句的格式灯节,然后,在每一行的末尾增加兩個(gè)空格缠俺,試試看显晶,是不是得到了漂亮的排版?
靈臺無計(jì)逃神矢壹士,
風(fēng)雨如磐暗故園磷雇。
寄意寒星荃不察,
我以我血薦軒轅躏救。
—— 魯迅
恭喜您
恭喜您唯笙,您此時(shí)可以正式開始使用 Markdown 書寫您的文章或者博文了,基本的用法就這些盒使,您花費(fèi)了5分鐘時(shí)間閱讀本文學(xué)習(xí)到了Markdown的使用崩掘,會(huì)讓您以后在寫作時(shí)受益匪淺。如果您需要繼續(xù)了解學(xué)習(xí)Markdown的更多用法少办。我會(huì)在以后的博文中深入講解苞慢。
在這里給您推薦一些有用的Markdown網(wǎng)站,
https://www.markdowntutorial.com 由 gjtorikian 提供的在線教程非常棒英妓。
http://en.wikipedia.org/wiki/Markdown Wiki 提供的Markdown介紹挽放。
https://www.markdownguide.org 提供了Markdown的基本語法和擴(kuò)展語法介紹。