獻(xiàn)給寫作者的 Markdown 新手指南 簡書

<meta charset="utf-8">

「簡書」作為一款「寫作軟件」在誕生之初就支持了 Markdown定躏,Markdown 是一種「電子郵件」風(fēng)格的「標(biāo)記語言」,我們強(qiáng)烈推薦所有寫作者學(xué)習(xí)和掌握該語言。為什么?可以參考:

在此,我們總結(jié) Markdown 的優(yōu)點如下:

  • 純文本腔寡,所以兼容性極強(qiáng)趾诗,可以用所有文本編輯器打開。
  • 讓你專注于文字而不是排版蹬蚁。
  • 格式轉(zhuǎn)換方便恃泪,Markdown 的文本你可以輕松轉(zhuǎn)換為 html、電子書等犀斋。
  • Markdown 的標(biāo)記語法有極好的可讀性贝乎。

當(dāng)然,我們既然如此推崇 Markdown 叽粹,也必定會教會你使用 Markdown 览效,這也是本文的目的所在。不過虫几,雖然 Markdown 的語法已經(jīng)足夠簡單锤灿,但是現(xiàn)有的 Markdown 語法說明更多的是寫給 web 從業(yè)者看的,對于很多寫作者來說辆脸,學(xué)習(xí)起來效率很低但校,現(xiàn)在,我們特地為寫作者量身定做本指南啡氢,從寫作者的實際需求出發(fā)状囱,介紹寫作者真正實用的常用格式术裸,深入淺出、圖文并茂地讓您迅速掌握 Markdown 語法亭枷。

為了使您更好地學(xué)習(xí)袭艺,我們建議您登錄[「簡書」](http://www. jianshu.com),將您的編輯器切換至 Markdown 編輯器叨粘,新建一篇空白筆記猾编,然后點擊右上角的預(yù)覽模式:

image

此時,您的界面應(yīng)當(dāng)如下圖所示升敲,左側(cè)為編輯區(qū)域答倡,右側(cè)為預(yù)覽區(qū)域,您在左側(cè)輸入 Markdown 語法的文本冻晤,右側(cè)會立即幫您呈現(xiàn)最終結(jié)果苇羡,好了,讓我們開始學(xué)習(xí)吧~

image

標(biāo)題

這是最為常用的格式鼻弧,在平時常用的的文本編輯器中大多是這樣實現(xiàn)的:輸入文本设江、選中文本、設(shè)置標(biāo)題格式攘轩。

而在 Markdown 中叉存,你只需要在文本前面加上 # 即可,同理度帮、你還可以增加二級標(biāo)題歼捏、三級標(biāo)題、四級標(biāo)題笨篷、五級標(biāo)題和六級標(biāo)題瞳秽,總共六級,只需要增加 # 即可率翅,標(biāo)題字號相應(yīng)降低练俐。例如:

# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題 

注:# 和「一級標(biāo)題」之間建議保留一個字符的空格,這是最標(biāo)準(zhǔn)的 Markdown 寫法冕臭。

你可以你的編輯器中嘗試輸入這六級標(biāo)題腺晾,可以參考下方的截圖:

image

列表

列表格式也很常用,在 Markdown 中辜贵,你只需要在文字前面加上 - 就可以了悯蝉,例如:

- 文本1
- 文本2
- 文本3

如果你希望有序列表,
也可以在文字前面加上 1. 2. 3. 就可以了托慨,例如:

1\. 文本1
2\. 文本2
3\. 文本3

注:-鼻由、1.和文本之間要保留一個字符的空格。

列表案例截圖如下:

image

<h2 id="picture"> 鏈接和圖片</h2>

在 Markdown 中,插入鏈接不需要其他按鈕嗡靡,你只需要使用 [顯示文本](鏈接地址) 這樣的語法即可跺撼,例如:

[簡書](http://www.reibang.com)

在 Markdown 中窟感,插入圖片不需要其他按鈕讨彼,你只需要使用 [圖片上傳失敗...(image-9488b3-1599463272848)] 這樣的語法即可,例如:

![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

注:插入圖片的語法和鏈接的語法很像柿祈,只是前面多了一個 哈误!

插入鏈接和圖片的案例截圖:

image

引用

在我們寫作的時候經(jīng)常需要引用他人的文字躏嚎,這個時候引用這個格式就很有必要了蜜自,在 Markdown 中,你只需要在你希望引用的文字前面加上 > 就好了卢佣,例如:

> 一盞燈重荠, 一片昏黃; 一簡書虚茶, 一杯淡茶戈鲁。 守著那一份淡定, 品讀屬于自己的寂寞嘹叫。 保持淡定婆殿, 才能欣賞到最美麗的風(fēng)景! 保持淡定罩扇, 人生從此不再寂寞婆芦。

注:> 和文本之間要保留一個字符的空格。

最終顯示的就是:

一盞燈喂饥, 一片昏黃消约; 一簡書, 一杯淡茶员帮。 守著那一份淡定或粮, 品讀屬于自己的寂寞。 保持淡定集侯, 才能欣賞到最美麗的風(fēng)景被啼! 保持淡定, 人生從此不再寂寞棠枉。

引用的案例截圖:

image

粗體和斜體

Markdown 的粗體和斜體也非常簡單浓体,用兩個 * 包含一段文本就是粗體的語法,用一個 * 包含一段文本就是斜體的語法辈讶。例如:

 *一盞燈*命浴, 一片昏黃;**一簡書**, 一杯淡茶生闲。 守著那一份淡定媳溺, 品讀屬于自己的寂寞。 保持淡定碍讯, 才能欣賞到最美麗的風(fēng)景悬蔽! 保持淡定, 人生從此不再寂寞捉兴。

最終顯示的就是下文蝎困,其中「一盞燈」是斜體,「一簡書」是粗體:

一盞燈倍啥, 一片昏黃禾乘;一簡書, 一杯淡茶虽缕。 守著那一份淡定始藕, 品讀屬于自己的寂寞。 保持淡定氮趋, 才能欣賞到最美麗的風(fēng)景伍派! 保持淡定, 人生從此不再寂寞凭峡。

粗體和斜體的案例截圖:

image

代碼引用

需要引用代碼時拙已,如果引用的語句只有一段,不分行摧冀,可以用 ` 將語句包起來倍踪。
如果引用的語句為多行,可以將```置于這段代碼的首行和末行索昂。
代碼引用的案例截圖:

image

表格

相關(guān)代碼:

| Tables        | Are           | Cool  |
| ------------- |:-------------:| -----:|
| col 3 is      | right-aligned | $1600 |
| col 2 is      | centered      |   $12 |
| zebra stripes | are neat      |    $1 |

顯示效果:

Tables Are Cool
col 3 is right-aligned $1600
col 2 is centered $12
zebra stripes are neat $1

<p></p>
相關(guān)代碼:

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

顯示效果:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

<p></p>

顯示鏈接中帶括號的圖片

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20(n_{i})+1

代碼如下:

![][1]
[1]: http://latex.codecogs.com/gif.latex?\prod%20\(n_{i}\)+1

結(jié)語

以上幾種格式是比較常用的格式建车,所以我們針對這些語法做了比較詳細(xì)的說明。除這些之外椒惨,Markdown 還有其他語法缤至,如想了解和學(xué)習(xí)更多,可以參考這篇『Markdown 語法說明』康谆。

強(qiáng)烈建議您現(xiàn)在就立馬用 Markdown 寫一篇文章吧领斥,體會一下 Markdown 的優(yōu)雅之處!

最后沃暗,希望我們的指南可以幫助到您月洛,也希望「簡書」能夠成為您書寫 Markdown 的最佳選擇。

作者:簡書
鏈接:http://www.reibang.com/p/q81RER
來源:簡書
著作權(quán)歸作者所有孽锥。商業(yè)轉(zhuǎn)載請聯(lián)系作者獲得授權(quán)嚼黔,非商業(yè)轉(zhuǎn)載請注明出處细层。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市唬涧,隨后出現(xiàn)的幾起案子疫赎,更是在濱河造成了極大的恐慌,老刑警劉巖碎节,帶你破解...
    沈念sama閱讀 222,865評論 6 518
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件捧搞,死亡現(xiàn)場離奇詭異,居然都是意外死亡钓株,警方通過查閱死者的電腦和手機(jī)实牡,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,296評論 3 399
  • 文/潘曉璐 我一進(jìn)店門陌僵,熙熙樓的掌柜王于貴愁眉苦臉地迎上來轴合,“玉大人,你說我怎么就攤上這事碗短∈芨穑” “怎么了?”我有些...
    開封第一講書人閱讀 169,631評論 0 364
  • 文/不壞的土叔 我叫張陵偎谁,是天一觀的道長总滩。 經(jīng)常有香客問我,道長巡雨,這世上最難降的妖魔是什么闰渔? 我笑而不...
    開封第一講書人閱讀 60,199評論 1 300
  • 正文 為了忘掉前任,我火速辦了婚禮铐望,結(jié)果婚禮上冈涧,老公的妹妹穿的比我還像新娘。我一直安慰自己正蛙,他們只是感情好督弓,可當(dāng)我...
    茶點故事閱讀 69,196評論 6 398
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著乒验,像睡著了一般愚隧。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上锻全,一...
    開封第一講書人閱讀 52,793評論 1 314
  • 那天狂塘,我揣著相機(jī)與錄音,去河邊找鬼鳄厌。 笑死荞胡,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的部翘。 我是一名探鬼主播硝训,決...
    沈念sama閱讀 41,221評論 3 423
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了窖梁?” 一聲冷哼從身側(cè)響起赘风,我...
    開封第一講書人閱讀 40,174評論 0 277
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎纵刘,沒想到半個月后邀窃,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,699評論 1 320
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡假哎,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,770評論 3 343
  • 正文 我和宋清朗相戀三年瞬捕,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片舵抹。...
    茶點故事閱讀 40,918評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡肪虎,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出惧蛹,到底是詐尸還是另有隱情扇救,我是刑警寧澤,帶...
    沈念sama閱讀 36,573評論 5 351
  • 正文 年R本政府宣布香嗓,位于F島的核電站迅腔,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏靠娱。R本人自食惡果不足惜沧烈,卻給世界環(huán)境...
    茶點故事閱讀 42,255評論 3 336
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望像云。 院中可真熱鬧锌雀,春花似錦、人聲如沸苫费。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,749評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽百框。三九已至闲礼,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間铐维,已是汗流浹背柬泽。 一陣腳步聲響...
    開封第一講書人閱讀 33,862評論 1 274
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留嫁蛇,地道東北人锨并。 一個月前我還...
    沈念sama閱讀 49,364評論 3 379
  • 正文 我出身青樓,卻偏偏與公主長得像睬棚,于是被迫代替她去往敵國和親第煮。 傳聞我的和親對象是個殘疾皇子解幼,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 45,926評論 2 361