markdown使用指南

Markdown 語法

現(xiàn)在可以在作業(yè)部落的左側(cè)窗口中試試看了羡洁。無需注冊玷过,直接開始輸入文字就好爽丹。

要事第一

首先需要注意:在 Markdown 中另起一段時筑煮,需要多敲一次回車鍵辛蚊,來在段落之間添加一個空行。這是與其他常見文檔格式的不同之處真仲。

這是因為袋马,在一些 Markdown 解釋器中,會把相鄰的兩行合并成同一個段落秸应。

例如虑凛,當我們這樣書寫時:

這是第一段。
這是第二段软啼。

實際上看到的效果是這樣:

這是第一段桑谍。這是第二段。

雖然并非所有 Markdown 解釋器都會用同樣的解釋方式祸挪,但是為了避免出錯锣披,還是多敲一次回車來添加一個空行吧。

標題

Markdown 中贿条,只需要在文本前面加上“#”雹仿,就會被認為是加了一個標題。同理整以,你還可以增加二級胧辽、三級、四級公黑、五級標題和六級標題邑商,只需要增加“#” 即可。例如:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

列表

當你要羅列一些內(nèi)容時帆调,列表是很有用的工具奠骄。為了說明哪些條目屬于這個列表,我們需要引入“項目標記”番刊。

列表項目標記通常放在段落開頭含鳞,后面要跟著一個空格。列表的各個條目之間可以不留空行芹务。

若列表中的條目沒有特定順序時蝉绷,可以使用 無序列表。加號“+”或減號“-”都可以作為列表標記枣抱,后面要跟一個空格熔吗。例如:

  • Red

  • Green

  • Blue

或者

  • Red

  • Green

  • Blue

實際顯示的效果都是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

  • Red

  • Green

  • Blue

若想在段落前加上數(shù)字序號,就需要用到有序列表了佳晶。使用數(shù)字桅狠、一個英文句號和一個空格即可。例如:

1. Red

2. Green

3. Blue

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

  1. Red

  2. Green

  3. Blue

圖片

Markdown 中可以插入圖片,只需要感嘆號中跌、方括號和圓括號即可咨堤。例如:

[圖片上傳失敗...(image-7fa733-1509632677704)]

一個英文感嘆號 “!” 后緊跟方括號,里面可以寫這張圖片的說明漩符;再緊跟一對圓括號一喘,里面寫這張圖片的網(wǎng)址。例如:

[圖片上傳失敗...(image-3c5634-1509632677705)])

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

image

有些 Markdown 編輯器也支持拖拽插入圖片嗜暴,這就簡單多了凸克。例如簡書 或者 Ulysses 就有這種功能。

鏈接

在文檔中插入連接的語法和插入圖片的語法很像闷沥,只是少了最前面的英文感嘆號"!"萎战。

在方括號寫下鏈接文字,圓括號寫下網(wǎng)址即可舆逃。例如:

好中文的樣子

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

好中文的樣子

引用

可以使用">" 標記來引用其他人的言論撞鹉、書籍或報紙的內(nèi)容。只需要在段落的第一行最前面加上 > 即可:

”每位作者都應(yīng)該學(xué)習(xí) Markdown颖侄∧癯” ——王佩

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

”每位作者都應(yīng)該學(xué)習(xí) Markdown±雷妫” ——王佩

引用可以嵌套孝鹊,只要根據(jù)層次的不同,加上不同數(shù)量的 > 即可:

這是第一級引用展蒂。

這是第二級引用又活。

現(xiàn)在回到第一級引用。

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

這是第一級引用锰悼。

這是第二級引用柳骄。

現(xiàn)在回到第一級引用。

在引用的區(qū)域內(nèi)箕般,也可以使用其他的 Markdown 語法耐薯,包括標題、列表等:

這是一個標題丝里。

1. 這是第一行列表項曲初。

2. 這是第二行列表項。

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

這是一個標題杯聚。

  1. 這是第一行列表項臼婆。
  1. 這是第二行列表項。

強調(diào)

在Markdown中幌绍,可以使用 * 和 _ 來表示斜體加粗颁褂。需要注意的是故响,“_”是下劃線而非減號“-”。

在需要斜體的文本左右各加一個“*”或“_” :

吹吹那熱風(fēng)颁独,聽聽那冷雨被去,看哪,好中文的樣子奖唯。

吹吹那熱風(fēng),聽聽那冷雨糜值,看哪丰捷,好中文的樣子。

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

吹吹那熱風(fēng)寂汇,聽聽那冷雨病往,看哪,好中文的樣子骄瓣。

吹吹那熱風(fēng)停巷,聽聽那冷雨,看哪榕栏,好中文的樣子畔勤。

在需要加粗的文本左右各加兩個“*”或“_” :

吹吹那熱風(fēng),聽聽那冷雨扒磁,看哪庆揪,好中文的樣子。

吹吹那熱風(fēng)妨托,聽聽那冷雨缸榛,看哪,好中文的樣子兰伤。

實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):

吹吹那熱風(fēng)内颗,聽聽那冷雨,看哪敦腔,好中文的樣子均澳。

吹吹那熱風(fēng),聽聽那冷雨符衔,看哪负懦,好中文的樣子。

分割線

在 Markdown 中柏腻,可以用分隔線來將內(nèi)容分成不同區(qū)域纸厉。

只需要連續(xù)三個減號"-"即可。例如:


實際顯示的效果是這樣的(在不同的環(huán)境下顯示效果可能會有差異):


5 常見問題

Q: 我該去哪里下載 Markdown 軟件五嫂?

A: Markdown 是一種標準而非軟件颗品,任何支持 Markdown 語法的編輯器都可以使用肯尺,無論是何種操作系統(tǒng)、哪類設(shè)備躯枢。請看“3 支持 Markdown 的編輯器”则吟,或者問問 Google。


Q:在簡書里怎么切換 Markdown锄蹂?為什么切換了沒有反應(yīng)氓仲?

A:建議使用 Chrome 或 Firefox 瀏覽器。在簡書中得糜,點擊右上角個人頭像-設(shè)置敬扛,在“常用編輯器”中選中markdown,然后保存朝抖。注意一行小字:“切換后對新建文章生效”啥箭。然后點擊右上角”寫新文章“,再點擊工具欄右側(cè)倒數(shù)第三個按鈕“切換到預(yù)覽模式”治宣,屏幕應(yīng)該會分成左右兩個區(qū)域急侥。在左側(cè)區(qū)域輸入內(nèi)容、添加標記侮邀,右側(cè)就會實時顯示 Markdown 效果了坏怪。


Q: 為什么我按說明寫了標記,但是沒法正常顯示绊茧?

A: 很可能是你誤把中文標點當成了英文標點陕悬。在 Markdown 中使用標點符號作為標記時,要使用英文標點符號按傅。沒關(guān)系捉超,人們總會犯這種小錯誤。


Q: 為什么我寫了正確的標記唯绍,但是在編輯窗口中看不到任何效果拼岳?

A: 許多 Markdown 編輯器都不是所見即所得的——“所見即所得”是指你對格式的修改會馬上反映在屏幕上,就像 Word 那樣况芒。如果你的編輯器沒有沒有實時預(yù)覽功能惜纸,就不會看到格式的變化。Macdown簡書 都支持實時預(yù)覽绝骚,你需要先打開這個功能耐版,才能看到這些格式標記的效果。


Q: Markdown 可以排版表格嗎压汪?

A: 可以粪牲,如果你熟練的話,排版表格也會很快止剖。表格的語法請見“Markdown 語法說明(簡體中文版)”腺阳。


Q: Markdown可以排版數(shù)學(xué)公式嗎落君?

A: 可以。只要有相應(yīng)的擴展亭引,Markdown 可以支持LaTeX 公式绎速、甚至畫流程圖和甘特圖。


Q: 標題效果和加粗有區(qū)別嗎焙蚓?

A: 看似沒有纹冤,其實還是有的。這涉及到如何解釋 Markdown 標記的問題购公,一般和 CSS 有關(guān)萌京。更多信息,請看“6 擴展閱讀”部分君丁。


Q: 加圖片時,無 IT 背景人士一般會采用從桌面拖拽的方式将宪。Markdown 支持拖拽嗎绘闷?

A: 拖拽圖片插入文檔或上傳到網(wǎng)站,不是 Markdown 語法本身的內(nèi)容较坛。不過有些網(wǎng)站和 Markdown 編輯器支持拖拽方式印蔗,例如 Ulysess簡書


Q: Markdown 正文可以調(diào)整字號嗎丑勤?

A: 同樣和解釋 Markdown 標記的方式有關(guān)华嘹。更多信息,請看“6 擴展閱讀”部分法竞。


Q: Markdown 段落開頭不能空兩格耙厚,看著很難受啊。有辦法解決嗎岔霸?

A: 辦法嘛……若是在自己機器上的 Markdown 編輯器中薛躬,也許你可以修改 CSS。若是在 簡書 之類網(wǎng)站上呆细,可能只能手工在每段開始前手工添加五個“&n bsp;”了型宝。記得,是“&nb sp;”絮爷,字符和字母之間都沒有空格趴酣。最后的分號也是有必要的哦~

作者:葉猛犸
鏈接:http://www.reibang.com/p/38fe4911b4a0
來源:簡書
著作權(quán)歸作者所有。商業(yè)轉(zhuǎn)載請聯(lián)系作者獲得授權(quán)坑夯,非商業(yè)轉(zhuǎn)載請注明出處岖寞。</pre>

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市柜蜈,隨后出現(xiàn)的幾起案子慎璧,更是在濱河造成了極大的恐慌床嫌,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件胸私,死亡現(xiàn)場離奇詭異厌处,居然都是意外死亡,警方通過查閱死者的電腦和手機岁疼,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進店門阔涉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人捷绒,你說我怎么就攤上這事瑰排。” “怎么了暖侨?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵椭住,是天一觀的道長。 經(jīng)常有香客問我字逗,道長京郑,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任葫掉,我火速辦了婚禮些举,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘俭厚。我一直安慰自己户魏,他們只是感情好,可當我...
    茶點故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布挪挤。 她就那樣靜靜地躺著叼丑,像睡著了一般。 火紅的嫁衣襯著肌膚如雪扛门。 梳的紋絲不亂的頭發(fā)上幢码,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天,我揣著相機與錄音尖飞,去河邊找鬼症副。 笑死,一個胖子當著我的面吹牛政基,可吹牛的內(nèi)容都是我干的贞铣。 我是一名探鬼主播,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼沮明,長吁一口氣:“原來是場噩夢啊……” “哼辕坝!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起荐健,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤酱畅,失蹤者是張志新(化名)和其女友劉穎琳袄,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體纺酸,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡窖逗,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了餐蔬。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片碎紊。...
    茶點故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖樊诺,靈堂內(nèi)的尸體忽然破棺而出仗考,到底是詐尸還是另有隱情,我是刑警寧澤词爬,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布秃嗜,位于F島的核電站对人,受9級特大地震影響歧寺,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜煤痕,卻給世界環(huán)境...
    茶點故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一虽惭、第九天 我趴在偏房一處隱蔽的房頂上張望橡类。 院中可真熱鬧蛇尚,春花似錦芽唇、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至谱邪,卻和暖如春炮捧,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背惦银。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工咆课, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人扯俱。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓书蚪,卻偏偏與公主長得像,于是被迫代替她去往敵國和親迅栅。 傳聞我的和親對象是個殘疾皇子殊校,可洞房花燭夜當晚...
    茶點故事閱讀 44,577評論 2 353

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