# Markdown 是什么,？

Markdown 是一種輕量級的標記語言,，可用于在純文本文檔中添加格式化元素。Markdown 由 John Gruber 于 2004 年創(chuàng)建,，如今已成為世界上最受歡迎的標記語言之一,。

1. 專注于文字內(nèi)容；
2. 純文本,，易讀易寫,，可以方便地納入版本控制；
3. 語法簡單,，沒有什么學習成本,，能輕松在碼字的同時做出美觀大方的排版。

使用 Markdown 與使用 Word 類編輯器不同,。在 Word 之類的應用程序中,，單擊按鈕以設(shè)置單詞和短語的格式,，并且,，更改立即可見。而 Markdown 與此不同,，當你創(chuàng)建 Markdown 格式的文件時,，可以在文本中添加 Markdown 語法，以指示哪些單詞和短語看起來應該有所不同,。

例如,，要表示標題，只須在短語前面添加一個井號即可（例如,， # Heading One）,?；蛘咭哟忠粋€短語，只須在短語前后各加兩個星號即可（例如,，**this text is bold**）,。可能需要一段時間才能習慣在文本中看到 Markdown 語法,，尤其是如果你已習慣了所見即所得的應用程序,。以下屏幕截展示了 Markdown 文件在 [Notepad++ 文本編輯器] 中顯示的效果。

你可以使用文本編輯器為純文本文件添加 Markdown 格式的元素,?；蛘撸阋部梢园惭b針對 macOS,、Windows,、Linux、iOS 和 Android 操作系統(tǒng)的 Markdown 應用程序,?；蛘哌€可以使用一些基于 Web 的應用程序用于 Markdown 編寫。

依賴于你所使用的應用程序,，你可能無法實時預覽格式化的文檔,。但是沒關(guān)系。根據(jù) Gruber 的說法,，Markdown 的語法被設(shè)計為可讀性強且不顯眼,，因此即使 Markdown 文件中的文本未經(jīng)過渲染也易于閱讀。

Markdown 語法的首要設(shè)計目標是盡可能易讀,?；谶@個目標，Markdown 格式的文檔能夠以純文本形式原樣發(fā)布,，而不會看起來像被填滿了標簽或格式化指令,。

# 為什么要使用 Markdown？

當你可以通過按下界面中的按鈕來設(shè)置文本格式時,，為什么還要使用 Markdown 來書寫呢,？使用 Markdown 而不是 word 類編輯器的原因有：

• Markdown 無處不在。StackOverflow,、CSDN,、掘金、簡書,、GitBook,、有道云筆記、V2EX、光谷社區(qū)等,。主流的代碼托管平臺,，如 GitHub、GitLab,、BitBucket,、Coding、Gitee 等等,，都支持 Markdown 語法,，很多開源項目的 README、開發(fā)文檔,、幫助文檔,、Wiki 等都用 Markdown 寫作。

• Markdown 是純文本可移植的,。幾乎可以使用任何應用程序打開包含 Markdown 格式的文本文件,。如果你不喜歡當前使用的 Markdown 應用程序了，則可以將 Markdown 文件導入另一個 Markdown 應用程序中,。這與 Microsoft Word 等文字處理應用程序形成了鮮明的對比,，Microsoft Word 將你的內(nèi)容鎖定在專有文件格式中。

• Markdown 是獨立于平臺的,。你可以在運行任何操作系統(tǒng)的任何設(shè)備上創(chuàng)建 Markdown 格式的文本,。

• Markdown 能適應未來的變化。即使你正在使用的應用程序?qū)頃谀硞€時候不能使用了,，你仍然可以使用文本編輯器讀取 Markdown 格式的文本,。當涉及需要無限期保存的書籍、大學論文和其他里程碑式的文件時,，這是一個重要的考慮因素,。

# 工欲善其事，必先利其器

Markdown 入門的最佳方式就是多使用它,。由于有大量免費工具的存在,，上手 Markdown 是很方便的。比較遺憾的一點是各平臺可能采用不同語言實現(xiàn)的 Markdown 解析引擎,，或采用同一解析引擎的不同版本,，而且可能有不同程度的定制與擴展，這導致在不同平臺上使用 Markdown 寫作時體驗并不完全一致,。不過幸好對于大家公認的一些標準語法,，各家都是支持的,。

你甚至都不需要下載任何程序,，就可以使用在線 Markdown 編輯器 來編寫 Markdown。進入其站點就可以開始在左側(cè)窗格中書寫了。渲染后的文檔在右側(cè)窗格預覽,。

閱讀本指南時,，你可以打開 在線 Markdown 編輯器 。這樣,，你就可以一邊學習 Markdown 語法一邊練習了,。熟悉 Markdown 之后，再選擇一個順手的 Markdown 的應用程序,。

# Markdown 的工作原理

在使用 Markdown 格式書寫時,，文本內(nèi)容存儲在帶有 .md 或 .markdown 擴展名的純文本文件中。那然后呢,？你的 Markdown 格式的文件如何轉(zhuǎn)換為 HTML 或可打印的文檔呢,？

簡單來說，你需要一個能夠處理 Markdown 文件的 Markdown 應用程序,。有許多應用程序可供選擇,，從簡單的腳本到類似于 Microsoft Word 的桌面應用程序。盡管它們在視覺上有所不同,，但所有應用程序都執(zhí)行相同的操作,。像 在線 Markdown 編輯器 一樣，它們都是將 Markdown 格式的文本轉(zhuǎn)換為 HTML,，以便可以在 Web 瀏覽器中顯示,。

Markdown 應用程序使用一種稱為 Markdown 處理器（也通常稱為“解析器”或“實現(xiàn)”）的東西將獲取到的 Markdown 格式的文本輸出為 HTML 格式。此時,，可以在 Web 瀏覽器中查看你的文檔，或者將其與樣式表組合并打印,。你可以在下圖看到此過程的直觀表示,。

注意： Markdown 應用程序和處理器是兩個單獨的組件。為了簡潔起見,，在下圖中,，我將它們組合為一個元素（即 “Markdown應用程序”）。

總而言之,，這是一個四步的過程：

1. 使用文本編輯器或 Markdown 專用的應用程序創(chuàng)建 Markdown 文件,。該文件應帶有 .md 或 .markdown 擴展名。
2. 在 Markdown 應用程序中打開 Markdown 文件,。
3. 使用 Markdown 應用程序?qū)?Markdown 文件轉(zhuǎn)換為 HTML 文檔,。
4. 在 web 瀏覽器中查看 HTML 文件，或使用 Markdown 應用程序?qū)⑵滢D(zhuǎn)換為其他文件格式,，例如 PDF,。

從你的角度來看,，該過程將根據(jù)你使用的應用程序的不同而有所不同。例如,，在線 Markdown 編輯器 本質(zhì)上將第 1-3 步組合到一個單一,、無縫的界面中，你要做的就是在左窗格中鍵入內(nèi)容,，然后轉(zhuǎn)換結(jié)果就在右窗格中就神奇地出現(xiàn)了,。但是，如果你使用的是其他工具（例如帶有靜態(tài)網(wǎng)站生成器的文本編輯器）,，則會發(fā)現(xiàn)該過程更為明顯,。

# Markdown 有什么用？

Markdown 是做筆記,、為網(wǎng)站創(chuàng)建內(nèi)容以及生成可打印文檔的快速,、簡便的方法。

學習 Markdown 語法并不需要很長時間,，一旦你知道如何使用它,，你就可以在幾乎所有地方使用 Markdown 進行書寫了。大多數(shù)人使用 Markdown 來為網(wǎng)站創(chuàng)建內(nèi)容,，但是 Markdown 也可以很好地格式化從電子郵件到購物清單的所有內(nèi)容,。

下面是一些你可以使用 Markdown 的場景。

# 網(wǎng)站

Markdown 是為 web 而設(shè)計的,，因此,，市面上有很多專門用于創(chuàng)建網(wǎng)站內(nèi)容的應用程序就不足為奇了。

如果您熟悉 HTML,、CSS和版本管理工具,，請試試 [Jekyll]，這是一個廣受歡迎的靜態(tài)網(wǎng)站生成器,，它能將 Markdown 文件并構(gòu)建為 HTML 網(wǎng)站,。這種方法的優(yōu)勢之一是 [GitHub Pages] 為 Jekyll 生成的網(wǎng)站提供免費托管服務(wù)。如果 Jekyll 不是你的理想之選,。

如果你是 WordPress 博主,，你可以使用 Jetpack 插件實現(xiàn)對 Markdown 的支持。

# 文件資料

Markdown 并不具備像 Microsoft Word 這樣的文字處理程序的所有功能,，但是對于創(chuàng)建基本文件（例如作業(yè)和信件）來說已經(jīng)足夠了,。你可以使用 Markdown 文檔創(chuàng)作工具來創(chuàng)建 Markdown 格式的文檔并將其導出為 PDF 或 HTML 格式。PDF 格式是關(guān)鍵,，因為一旦有了 PDF 文檔,，您就可以使用它進行任何操作：打印、通過電子郵件發(fā)送或?qū)⑵渖蟼鞯骄W(wǎng)站,。

這是我推薦的一些Markdown文檔創(chuàng)作工具：

• 現(xiàn)代編輯器
  VSCode / Atom

• 傳統(tǒng)編輯器
  Vim / Emacs / Sublime Text / Notepad++

• IDE 自帶編輯器
  IntelliJ IDEA / Android Studio / WebStorm

• 專用編輯器
  Ulysses / Mou / Typora / Markpad

• 在線編輯器
  各種支持 Markdown 的網(wǎng)站都提供了在線 Markdown 編輯器

# 筆記

在幾乎所有方面,，Markdown 都是記筆記的理想語法,。不幸的是，兩個最受歡迎的筆記應用程序 Evernote 和 OneNote 目前都不支持 Markdown,。好消息是，其他一些筆記應用程序 是 支持 Markdown 的：

• [Simplenote] 是適用于所有平臺的免費,、簡單的筆記應用程序,。
• [Notable] 是可以在各種平臺上運行的筆記應用程序。
• [Bear] 是適用于 Mac 和 iOS 設(shè)備的類似 Evernote 的應用程序,。默認情況下,，它并不專門針對 Markdown 的，但是你可以啟用 Markdown 兼容模式,。
• [Boostnote] 自稱是“專為程序員設(shè)計的開源筆記應用程序”,。

如果你無法放棄 Evernote，可以試試 Marxico,，一個專門針對 Evernote 的基于訂閱付費的 Markdown編輯器,，或在 Evernote 網(wǎng)站上使用 [Markdown Here] 插件。

# 書籍

想要自行出版小說,？請試試 Leanpub,，該服務(wù)可將你的 Markdown 格式的文件轉(zhuǎn)換為電子書。Leanpub 以 PDF,、EPUB 和 MOBI 文件格式輸出你的圖書,。如果你要創(chuàng)建紙版書籍，可以將 PDF 文件上傳到類似 Kindle Direct Publishing 之類的服務(wù)提供商處,。要了解有關(guān)使用 Markdown 編寫和自行出版書籍的更多信息,，請閱讀 此博文。

# 演示文稿

信不信由你,，你可以將 Markdown 格式的文件轉(zhuǎn)換成演示文稿,。在 Markdown 中創(chuàng)建演示文稿需要一點時間來適應，但是一旦你掌握了它,，你就能體會到比使用 PowerPoint 或 Keynote 之類的應用程序更快,、更容易。Remark（GitHub 倉庫）和 Cleaver（GitHub 倉庫）一樣,，是一種基于瀏覽器的,、流行的 Markdown 幻燈片工具。如果你使用的是 Mac,，并且希望安裝一個應用程序來使用的話,，請試試 Deckset 或 Marked。

# 郵件

如果你需要發(fā)送大量電子郵件,，并且對大多數(shù)電子郵件提供商網(wǎng)站上可用的格式設(shè)置控件感到厭倦,，那么你將很高興地發(fā)現(xiàn)有一種使用 Markdown 編寫電子郵件的簡便方法：[Markdown Here] 是一個免費,、開源的瀏覽器擴展程序，可將 Markdown 格式的文本轉(zhuǎn)換為可用于發(fā)送的 HTML,。

# 文檔

Markdown 非常適合技術(shù)文檔,。像 GitHub 這樣的公司越來越多地轉(zhuǎn)向使用 Markdown 來創(chuàng)建其文檔了，請查看此 博文 以了解如何將 Markdown 格式的文檔遷移到 [Jekyll],。如果你是為產(chǎn)品或服務(wù)編寫文檔,，請試試以下的便捷工具：

• Read the Docs 可以將你所開源的 Markdown 文件生成文檔網(wǎng)站。只需將你的 GitHub 倉庫連接到他們的服務(wù),，然后你就可以將內(nèi)容推送到該倉庫中,，Read the Docs 會完成其余的工作。他們還為 商業(yè)實體提供服務(wù),。
• [MkDocs] 是一個快速,、簡單的靜態(tài)站點生成器，專門用于構(gòu)建項目文檔,。文檔源文件使用 Markdown 編寫,，并使用一個 YAML 配置文件進行配置。MkDocs 有多個 內(nèi)置主題,，包括移植自 Read the Docs 的文檔主題,。最新的一個主題是 MkDocs Material。
• [Docusaurus] 是一個靜態(tài)網(wǎng)站生成器,，專門用于創(chuàng)建文檔網(wǎng)站,。它支持翻譯、搜索和版本控制,。
• VuePress 是基于 Vue 構(gòu)建的靜態(tài)站點生成器,，并針對編寫技術(shù)文檔進行了優(yōu)化。
• [Jekyll] 前面已經(jīng)提到過它了,，但它也是將 Markdown 文件生成文檔網(wǎng)站的一個不錯的選擇,。如果你選擇 Jekyll，請務(wù)必試試 Jekyll 文檔主題,。

# Markdown 方言

使用 Markdown 的過程中,，最令人困惑的地方是：實際上每個 Markdown 應用程序都實現(xiàn)了稍有不同的 Markdown 語法。Markdown 的這些變體通常被稱為 flavors（方言）,。掌握你的應用程序所實現(xiàn)的 Markdown 語法是你需要主義的,。

為了讓你了解各 Markdown 變體的概念，將它們比作語言的方言（language dialects）可能會有所幫助,。華雷斯城（Ciudad Juárez）的人說西班牙語,，就像巴塞羅那（Barcelona）人一樣，但是兩個城市使用的方言之間有很大的不同,。使用不同 Markdown 應用程序的人也是如此,。Dillinger 支持的 Markdown 格式與 Ulysses 有著很大的不同,。

實際上，這意味著當一個應用程序說它支持 “Markdown” 時,，你永遠也不會確切地知到它的實際意思,。它說的是僅支持 基本語法？還是所有基本語法加 擴展語法 ,？或者是某些語法的組合呢,？在你閱讀其文檔或開始使用該應用程序之前，你永遠都不會知到,。

如果你只是新手,，我能給你的最好建議就是選擇一個具有良好 Markdown 支持的應用程序,。這對保持 Markdown 文件的可移植性大有幫助,。你可能需要在其它應用程序中保存或使用你的 Markdown 文件，要實現(xiàn)這一點,，你應當從使用一個具有良好 Markdown 支持的應用程序開始,。你可以在 Markdown 工具列表 中找到合適的應用程序。

# 其它資源

網(wǎng)上有很多資源用來學習 Markdown,。以下列出一些：

• John Gruber’s Markdown documentation. Markdown 的創(chuàng)建者編寫的原始指南,。
• Markdown Tutorial. 一個開源網(wǎng)站，你能用瀏覽器在這個網(wǎng)站上嘗試 Markdown,。
• Awesome Markdown. Markdown 工具和學習資源列表,。
• Typesetting Markdown. 這是一個系列教程，介紹了使用 pandoc 和 ConTeXt 對 Markdown 文檔進行排版的系統(tǒng),。