“人生有很多坑偶宫，完全可以單腳一躍而過；可是大多數(shù)人环鲤，卻偏偏要繞個(gè)大圈子纯趋。”
“對(duì)未知事物的恐懼冷离，幾乎是本能的反應(yīng)吧吵冒？”
——《Markdown 操作用戶反饋》，沐沐周
0 說明
不要恐慌西剥，不要恐慌痹栖，不要恐慌。
本教程是為王佩在簡(jiǎn)書開設(shè)的《好中文的樣子》課程而撰寫瞭空。該課程鼓勵(lì)作者使用 Markdown 寫作揪阿。
為什么要學(xué)習(xí)和使用 Markdown？如果你想要流暢表達(dá)想法咆畏，不想在鍵盤和鼠標(biāo)之間頻繁切換而中斷思路南捂；如果你想讓你的文稿可以在任何地方打開；想讓你的文稿一次排版旧找，到處可用溺健；想讓排版更快；需要和其他人一起協(xié)同寫作或翻譯——那么你應(yīng)該試試看 Markdown钦讳。
本文的目標(biāo)讀者矿瘦，是習(xí)慣以 Microsoft Office、Pages愿卒、WPS 或 LibraOffice 為寫作編輯軟件缚去，較少或從未使用過 Markdown 的計(jì)算機(jī)用戶。
本文假設(shè)讀者擁有一定計(jì)算機(jī)使用能力琼开，足以完成網(wǎng)絡(luò)搜索易结、瀏覽、文檔寫作與編輯等任務(wù)。
本文將會(huì)嘗試解釋一些概念搞动。這些解釋可能會(huì)幫助讀者更容易地理解躏精，但未必精準(zhǔn)。
互聯(lián)網(wǎng)上已經(jīng)有大量 Markdown 相關(guān)資料鹦肿，本文將會(huì)在“6 擴(kuò)展閱讀”部分給出一些擴(kuò)展閱讀材料矗烛。
做是最好的學(xué)。我們需要一個(gè)可以快速上手的Markdown 編輯器箩溃，它應(yīng)該可以實(shí)時(shí)預(yù)覽瞭吃。建議現(xiàn)在點(diǎn)擊作業(yè)部落，并且在閱讀本文時(shí)隨時(shí)嘗試涣旨。
1 Markdown 概述
Markdown 是一種輕量級(jí)標(biāo)記語言歪架。它是一種標(biāo)準(zhǔn)、一種語言霹陡，而非特定的軟件和蚪；所以我們一般說“Markdown 編輯器”，而不說“Markdown 軟件”烹棉。所有文本編輯器都能編輯 Markdown攒霹，挑自己喜歡順手的就好。
- “輕量級(jí)”：是指結(jié)構(gòu)簡(jiǎn)單峦耘，容易記憶也容易上手剔蹋。
- “標(biāo)記語言”：是指它會(huì)通過一些特定符號(hào)來實(shí)現(xiàn)特定功能旅薄；而這些符號(hào)會(huì)直接寫在文字當(dāng)中辅髓。我們將會(huì)在“4 Markdown 語法”部分詳細(xì)描述這些符號(hào)。
Markdown 語言的設(shè)計(jì)目標(biāo)是讓人們“使用易讀易寫的純文本格式編寫文檔少梁，并且可以轉(zhuǎn)換成其他格式洛口。”
- “純文本格式”：是指可以用最簡(jiǎn)單的文檔編輯器打開的格式凯沪，例如 Windows 上的“記事本”第焰、Mac 上的“TextEdit”，或一些 Linux 發(fā)行版上的“gedit”妨马。
- 一般來說挺举，純文本格式文件的擴(kuò)展名是“.txt”，這是最通用的文檔文件格式烘跺，所有文本編輯器都能打開湘纵。
- Markdown 文檔的擴(kuò)展名是“.md”或“.markdown”，一般建議使用“.md”滤淳。
- “轉(zhuǎn)換成其他格式”：Markdown 格式可以輕松地轉(zhuǎn)化成日常使用的大部分文檔格式梧喷，包括但不限于.doc .html .pdf 等。
Markdown 最重要的設(shè)計(jì)是可讀性。撰寫 Markdown 不是為了讓機(jī)器更容易讀取铺敌，而是為了讓人能夠輕松閱讀汇歹。
Markdown 已經(jīng)獲得了許多網(wǎng)站的支持，并且成為了 Github、Reddit 等著名社區(qū)的標(biāo)準(zhǔn)辟癌。
2 Markdown 與 Microsoft Word 的對(duì)比
在這一部分量窘，將從以下幾個(gè)方面，對(duì)比 Markdown 和 Microsoft Word 取视。
通用程度：
- Markdown 的 .md 格式：所有的文本編輯器都可以編輯。在“3 支持 Markdown 的編輯器”中列出了常見工具常挚。
- Word 的 .doc 或 .docx 格式：只有 Microsoft Word作谭、 LibraOffice、WPS 等幾種軟件能夠編輯奄毡。
學(xué)習(xí)難度：
- Markdown：幾分鐘就可以學(xué)會(huì)常用語法折欠。
- Word：“大部分人只用到了 Word 不到 5% 的功能『鸸”看看書店里的教程數(shù)量和厚度就知道锐秦。
可讀性：
- Markdown 文檔：可讀性強(qiáng)，文本中的符號(hào)基本不會(huì)影響閱讀盗忱。
- Word 文檔：如果你有 Word 的話酱床，還不錯(cuò)；若是你沒有趟佃，強(qiáng)行打開 Word 文檔就只能看到一堆亂碼扇谣。
轉(zhuǎn)換成其他格式：
- Markdown：可以很容易地轉(zhuǎn)換成多種格式的文檔，當(dāng)然也包括 .doc 或 .docx闲昭。
- Word ：除了“另存為”對(duì)話框中提供的格式之外罐寨，只能尋找其他工具來幫助轉(zhuǎn)換。
管理不同版本：
- Markdown：可以使用通行的版本管理工具管理不同版本序矩，可以避免編輯時(shí)多份不同版本內(nèi)容沖突或丟失鸯绿。
- Word：通常的做法，是在 Word 文檔文件名后面加上一串?dāng)?shù)字簸淀，來手工管理版本瓶蝴。
協(xié)作：
- Markdown：可以使用 Github 等協(xié)同工具，多人同時(shí)或不同時(shí)編輯租幕。
- Word：一份文檔傳來傳去舷手，同一時(shí)間只能由一個(gè)人修改。
最重要的區(qū)別在于令蛉， Word 本質(zhì)上是一個(gè)排版軟件而非寫作支持軟件聚霜，大量按鈕和菜單讓人們很難專注于寫作本身狡恬。
而 Markdown 是種純粹而優(yōu)美的寫作工具，只是兼顧排版而已蝎宇。
3 支持 Markdown 的編輯器
Windows
推薦 Sublime Text 3弟劲，強(qiáng)大優(yōu)雅的編輯器。
MarkdownPad姥芥，一款可以直接預(yù)覽排版效果的編輯器兔乞。
Mac
推薦 Ulysess，專注寫作的編輯器凉唐，功能強(qiáng)大庸追，體驗(yàn)一流。
Macdown台囱，可以預(yù)覽排版效果淡溯。
Linux
推薦 VIM，編輯器之神簿训。當(dāng)然咱娶，Emacs是神的編輯器。
ReText强品，也可以預(yù)覽膘侮。
Web
推薦簡(jiǎn)書，有 Markdown 寫作/預(yù)覽模式的榛。
作業(yè)部落琼了，功能強(qiáng)大的 Markdown 編輯器。
與其他常用工具配合
在 Firefox 瀏覽器上夫晌，推薦插件 It’s All Text!雕薪，可以將網(wǎng)頁上的文本框轉(zhuǎn)化為 Markdown 編輯器。
在和 Evernote 配合使用時(shí)慷丽，推薦使用馬克飛象蹦哼。
擴(kuò)展閱讀
歡迎補(bǔ)充鳄哭，隨時(shí)更新要糊。
4 Markdown 語法
現(xiàn)在可以在作業(yè)部落的左側(cè)窗口中試試看了。無需注冊(cè)妆丘，直接開始輸入文字就好锄俄。
要事第一
首先需要注意：在 Markdown 中另起一段時(shí)，需要多敲一次回車鍵勺拣，來在段落之間添加一個(gè)空行奶赠。這是與其他常見文檔格式的不同之處。
這是因?yàn)橐┯校谝恍?Markdown 解釋器中毅戈，會(huì)把相鄰的兩行合并成同一個(gè)段落苹丸。
例如，當(dāng)我們這樣書寫時(shí)：
這是第一段苇经。
這是第二段赘理。
實(shí)際上看到的效果是這樣：
這是第一段。這是第二段扇单。
雖然并非所有 Markdown 解釋器都會(huì)用同樣的解釋方式商模，但是為了避免出錯(cuò)，還是多敲一次回車來添加一個(gè)空行吧蜘澜。
標(biāo)題
Markdown 中施流，只需要在文本前面加上“#”，就會(huì)被認(rèn)為是加了一個(gè)標(biāo)題鄙信。同理瞪醋，你還可以增加二級(jí)、三級(jí)装诡、四級(jí)趟章、五級(jí)標(biāo)題和六級(jí)標(biāo)題，只需要增加“#” 即可慎王。例如：
一級(jí)標(biāo)題
二級(jí)標(biāo)題
三級(jí)標(biāo)題
四級(jí)標(biāo)題
五級(jí)標(biāo)題
六級(jí)標(biāo)題
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
一級(jí)標(biāo)題
二級(jí)標(biāo)題
三級(jí)標(biāo)題
四級(jí)標(biāo)題
五級(jí)標(biāo)題
六級(jí)標(biāo)題
列表
當(dāng)你要羅列一些內(nèi)容時(shí)蚓土，列表是很有用的工具。為了說明哪些條目屬于這個(gè)列表赖淤，我們需要引入“項(xiàng)目標(biāo)記”蜀漆。
列表項(xiàng)目標(biāo)記通常放在段落開頭，后面要跟著一個(gè)空格咱旱。列表的各個(gè)條目之間可以不留空行确丢。
若列表中的條目沒有特定順序時(shí)，可以使用 無序列表吐限。加號(hào)“+”或減號(hào)“-”都可以作為列表標(biāo)記鲜侥，后面要跟一個(gè)空格。例如：
Red
Green
Blue
或者
Red
Green
Blue
實(shí)際顯示的效果都是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
- Red
- Green
- Blue
若想在段落前加上數(shù)字序號(hào)诸典，就需要用到有序列表了描函。使用數(shù)字、一個(gè)英文句號(hào)和一個(gè)空格即可狐粱。例如：
1. Red
2. Green
3. Blue
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
- Red
- Green
- Blue
圖片
Markdown 中可以插入圖片舀寓，只需要感嘆號(hào)、方括號(hào)和圓括號(hào)即可肌蜻。例如：
[圖片上傳失敗...(image-84d22e-1557723638584)]
一個(gè)英文感嘆號(hào) “!” 后緊跟方括號(hào)互墓，里面可以寫這張圖片的說明；再緊跟一對(duì)圓括號(hào)蒋搜，里面寫這張圖片的網(wǎng)址篡撵。例如：
[圖片上傳失敗...(image-c164a7-1557723638584)])
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
有些 Markdown 編輯器也支持拖拽插入圖片判莉，這就簡(jiǎn)單多了。例如簡(jiǎn)書 或者 Ulysses 就有這種功能育谬。
鏈接
在文檔中插入連接的語法和插入圖片的語法很像骂租，只是少了最前面的英文感嘆號(hào)"!"。
在方括號(hào)寫下鏈接文字斑司，圓括號(hào)寫下網(wǎng)址即可渗饮。例如：
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
引用
可以使用">" 標(biāo)記來引用其他人的言論、書籍或報(bào)紙的內(nèi)容宿刮。只需要在段落的第一行最前面加上 > 即可：
”每位作者都應(yīng)該學(xué)習(xí) Markdown互站。” ——王佩
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
”每位作者都應(yīng)該學(xué)習(xí) Markdown僵缺『遥” ——王佩
引用可以嵌套，只要根據(jù)層次的不同磕潮，加上不同數(shù)量的 > 即可：
這是第一級(jí)引用翠胰。
這是第二級(jí)引用。
現(xiàn)在回到第一級(jí)引用自脯。
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
這是第一級(jí)引用之景。
這是第二級(jí)引用。
現(xiàn)在回到第一級(jí)引用膏潮。
在引用的區(qū)域內(nèi)锻狗，也可以使用其他的 Markdown 語法，包括標(biāo)題焕参、列表等：
這是一個(gè)標(biāo)題轻纪。
1. 這是第一行列表項(xiàng)。
2. 這是第二行列表項(xiàng)叠纷。
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
這是一個(gè)標(biāo)題刻帚。
- 這是第一行列表項(xiàng)。
- 這是第二行列表項(xiàng)涩嚣。
強(qiáng)調(diào)
在Markdown中崇众，可以使用 * 和 _ 來表示斜體和加粗。需要注意的是缓艳，“_”是下劃線而非減號(hào)“-”校摩。
在需要斜體的文本左右各加一個(gè)“*”或“_” ：
吹吹那熱風(fēng)，聽聽那冷雨阶淘，看哪，好中文的樣子互妓。
吹吹那熱風(fēng)溪窒，聽聽那冷雨坤塞，看哪，好中文的樣子澈蚌。
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
吹吹那熱風(fēng)摹芙，聽聽那冷雨，看哪宛瞄，好中文的樣子浮禾。
吹吹那熱風(fēng)，聽聽那冷雨份汗，看哪盈电，好中文的樣子。
在需要加粗的文本左右各加兩個(gè)“*”或“_” ：
吹吹那熱風(fēng)杯活，聽聽那冷雨匆帚，看哪，好中文的樣子旁钧。
吹吹那熱風(fēng)吸重，聽聽那冷雨，看哪歪今，好中文的樣子嚎幸。
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
吹吹那熱風(fēng)，聽聽那冷雨寄猩，看哪鞭铆，好中文的樣子。
吹吹那熱風(fēng)焦影，聽聽那冷雨车遂，看哪，好中文的樣子斯辰。
分割線
在 Markdown 中舶担，可以用分隔線來將內(nèi)容分成不同區(qū)域。
只需要連續(xù)三個(gè)減號(hào)"-"即可彬呻。例如：
實(shí)際顯示的效果是這樣的（在不同的環(huán)境下顯示效果可能會(huì)有差異）：
5 常見問題
Q： 我該去哪里下載 Markdown 軟件衣陶？
A： Markdown 是一種標(biāo)準(zhǔn)而非軟件，任何支持 Markdown 語法的編輯器都可以使用闸氮，無論是何種操作系統(tǒng)剪况、哪類設(shè)備。請(qǐng)看“3 支持 Markdown 的編輯器”蒲跨，或者問問 Google译断。
Q：在簡(jiǎn)書里怎么切換 Markdown？為什么切換了沒有反應(yīng)或悲？
A：建議使用 Chrome 或 Firefox 瀏覽器孙咪。在簡(jiǎn)書中堪唐，點(diǎn)擊右上角個(gè)人頭像-設(shè)置，在“常用編輯器”中選中markdown翎蹈，然后保存淮菠。注意一行小字：“切換后對(duì)新建文章生效”。然后點(diǎn)擊右上角”寫新文章“荤堪，再點(diǎn)擊工具欄右側(cè)倒數(shù)第三個(gè)按鈕“切換到預(yù)覽模式”合陵，屏幕應(yīng)該會(huì)分成左右兩個(gè)區(qū)域。在左側(cè)區(qū)域輸入內(nèi)容澄阳、添加標(biāo)記拥知，右側(cè)就會(huì)實(shí)時(shí)顯示 Markdown 效果了。
Q： 為什么我按說明寫了標(biāo)記寇荧，但是沒法正常顯示举庶？
A： 很可能是你誤把中文標(biāo)點(diǎn)當(dāng)成了英文標(biāo)點(diǎn)。在 Markdown 中使用標(biāo)點(diǎn)符號(hào)作為標(biāo)記時(shí)揩抡，要使用英文標(biāo)點(diǎn)符號(hào)户侥。沒關(guān)系，人們總會(huì)犯這種小錯(cuò)誤峦嗤。
Q： 為什么我寫了正確的標(biāo)記蕊唐，但是在編輯窗口中看不到任何效果？
A： 許多 Markdown 編輯器都不是所見即所得的——“所見即所得”是指你對(duì)格式的修改會(huì)馬上反映在屏幕上烁设，就像 Word 那樣替梨。如果你的編輯器沒有沒有實(shí)時(shí)預(yù)覽功能，就不會(huì)看到格式的變化装黑。Macdown和簡(jiǎn)書 都支持實(shí)時(shí)預(yù)覽副瀑，你需要先打開這個(gè)功能，才能看到這些格式標(biāo)記的效果恋谭。
Q： Markdown 可以排版表格嗎糠睡？
A： 可以，如果你熟練的話疚颊，排版表格也會(huì)很快狈孔。表格的語法請(qǐng)見“Markdown 語法說明（簡(jiǎn)體中文版）”。
Q： Markdown可以排版數(shù)學(xué)公式嗎材义？
A： 可以均抽。只要有相應(yīng)的擴(kuò)展，Markdown 可以支持LaTeX 公式其掂、甚至畫流程圖和甘特圖油挥。
Q： 標(biāo)題效果和加粗有區(qū)別嗎？
A： 看似沒有，其實(shí)還是有的喘漏。這涉及到如何解釋 Markdown 標(biāo)記的問題护蝶，一般和 CSS 有關(guān)华烟。更多信息翩迈，請(qǐng)看“6 擴(kuò)展閱讀”部分。
Q： 加圖片時(shí)盔夜，無 IT 背景人士一般會(huì)采用從桌面拖拽的方式负饲。Markdown 支持拖拽嗎？
A： 拖拽圖片插入文檔或上傳到網(wǎng)站喂链，不是 Markdown 語法本身的內(nèi)容返十。不過有些網(wǎng)站和 Markdown 編輯器支持拖拽方式，例如 Ulysess 和 簡(jiǎn)書 椭微。
Q： Markdown 正文可以調(diào)整字號(hào)嗎洞坑？
A： 同樣和解釋 Markdown 標(biāo)記的方式有關(guān)。更多信息蝇率，請(qǐng)看“6 擴(kuò)展閱讀”部分迟杂。
Q： Markdown 段落開頭不能空兩格，看著很難受啊本慕。有辦法解決嗎排拷？
A： 辦法嘛……若是在自己機(jī)器上的 Markdown 編輯器中，也許你可以修改 CSS锅尘。若是在 簡(jiǎn)書 之類網(wǎng)站上监氢，可能只能手工在每段開始前手工添加五個(gè)“&n bsp;”了。記得藤违，是“&nb sp;”浪腐，字符和字母之間都沒有空格。最后的分號(hào)也是有必要的哦~
6 擴(kuò)展閱讀
更多關(guān)于 Markdown 語法或工具的內(nèi)容顿乒，可以參考：
- Markdown 語法說明（簡(jiǎn)體中文版）
- 獻(xiàn)給寫作者的 Markdown 新手指南
- Markdown 是定義文章邏輯結(jié)構(gòu)议街，而非定義樣式的。一般來說淆游，Markdown 最終呈現(xiàn)出的樣式傍睹，是由對(duì)應(yīng)的層疊樣式表（CSS）所定義的。如果想要自己調(diào)整出想要的樣式犹菱，可以從 CSS 開始拾稳。這里有一份 CSS 教程：《CSS 入門教程》
不斷擴(kuò)充中，歡迎補(bǔ)充腊脱。
本文是《好中文的樣子》課程 G056組小組協(xié)作作業(yè)的衍生作品访得。
計(jì)劃共有三篇。截止20170219：
- Markdown 新手手冊(cè)（本文）
- Git 新手手冊(cè)（撰寫中）
- GitHub 新手手冊(cè)（未開始）
更多內(nèi)容，請(qǐng)關(guān)注專題《GC4WPS03E05-番外》
撰寫：葉猛犸
其他貢獻(xiàn)者：Zoom.Quiet悍抑，粒粒如一鳄炉， 迷妹喬小喵，瑪雅藍(lán)
作者：葉猛犸
鏈接：http://www.reibang.com/p/38fe4911b4a0
來源：簡(jiǎn)書
簡(jiǎn)書著作權(quán)歸作者所有搜骡，任何形式的轉(zhuǎn)載都請(qǐng)聯(lián)系作者獲得授權(quán)并注明出處拂盯。
