一份 Markdown 簡介

一次編輯即可將文本轉換爲多種格式。下面是如何開始使用 Markdown。

在很長一段時間裏，我發現我在 GitLab 和 GitHub 上看到的全部文件都帶有 .md 擴展名，這是專門爲開發人員編寫的文件類型。幾周前，當我開始使用 Markdown 時，個人觀念發生了變化。它很快成爲我平常工做中最重要的工具。

Markdown 使個人生活更簡易。我只須要在已經編寫的代碼中添加一些符號，而且在瀏覽器擴展或開源程序的幫助下，便可將文本轉換爲各類經常使用格式，如 ODT、電子郵件（稍後將詳細介紹）、PDF 和 EPUB。

什麼是 Markdown?

來自 維基百科的友情提示:

Markdown 是一種輕量級標記語言，具備純文本格式語法。

這意味着經過在文本中使用一些額外的符號，Markdown 能夠幫助你建立具備特定結構和格式的文檔。當你以純文本（例如，在記事本應用程序中）作筆記時，沒有任何東西代表哪一個文本應該是粗體或斜體。在普通文本中，你在寫連接時須要將一個連接寫爲 「example.com」，或者寫爲 「example.com」，又或「訪問網站（example.com）」。這樣沒有內在的一致性。

可是若是你按照 Markdown 的方式編寫，你的文本就有了內在的一致性。計算機喜歡一致性，由於這使得它們可以遵循嚴格的指令而不用擔憂異常。

相信我；一旦你學會使用 Markdown，每一項寫做任務在某種程度上都會比之前更容易、更好。讓咱們開始吧。

Markdown 基礎

如下是使用 Markdown 的基礎語法。

一、建立一個以 .md 擴展名結尾的文本文件（例如，example.md）。你可使用任何文本編輯器（甚至像 LibreOffice 或 Microsoft word 這樣的文字處理程序亦可），只要記住將其保存爲文本文件。

Names of Markdown files

二、想寫什麼就寫什麼，就像往常同樣:

Lorem ipsum

Consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

De Finibus Bonorum et Malorum

Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.

  Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem.
複製代碼

（LCTT 譯註：上述這段「Lorem ipsum」，中文又稱「亂數假文」，是一篇經常使用於排版設計領域的拉丁文文章，主要目的爲測試文章或文字在不一樣字型、版型下看起來的效果。）

三、確保在段落之間留有空行。若是你習慣寫商務信函或傳統散文，這可能會以爲不天然，由於那裏段落只有一行，甚至在第一個單詞前還有一個縮進。對於 Markdown，空行（一些文字處理程序使用 ¶，稱爲Pilcrow 符號）保證在建立一個新段落應用另外一種格式（如 HTML）。

四、指定標題和副標題。對於文檔的標題，在文本前面添加一個井號或散列符號（#）和一個空格（例如 # Lorem ipsum）。第一個副標題級別使用兩個（## De Finibus Bonorum et Malorum），下一個級別使用三個（### 第三個副標題），以此類推。注意，在井號和第一個單詞之間有一個空格。

# Lorem ipsum

Consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

## De Finibus Bonorum et Malorum

Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.
Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.

  Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem.
複製代碼

五、若是你想使用粗體字符，只需將字母放在兩個星號之間，沒有空格：**對應的文本將以粗體顯示**。

Bold text in Markdown

六、對於斜體，將文本放在沒有空格的下劃線符號之間：_我但願這個本文以斜體顯示_。（LCTT 譯註：有的 Markdown 流派會將用下劃線引發來的字符串視做下劃線文本，而單個星號 * 引用起來的才視做斜體。從兼容性的角度看，使用星號比較兼容。）

Italics text in Markdown

七、要插入一個連接（像 Markdown Tutorial），把你想連接的文本放在括號裏，URL 放在括號裏，中間沒有空格：[Markdown Tutorial](<https://www.markdowntutorial.com/>)。

Hyperlinks in Markdown

八、塊引用是用大於號編寫的（>）在你要引用的文本前加上大於符號和空格: > 名言引用。

Blockquote text in Markdown

Markdown 教程和技巧

這些技巧能夠幫助你上手 Markdown ，但它涵蓋了不少功能，不只僅是粗體、斜體和連接。學習 Markdown 的最好方法是使用它，可是我建議你花 15 分鐘來學習這篇簡單的 Markdown 教程，學以至用，勤加練習。

因爲現代 Markdown 是對結構化文本概念的許多不一樣解釋的融合，CommonMark 項目定義了一個規範，其中包含一組嚴格的規則，以使 Markdown 更加清晰。在編輯時手邊準備一份符合 CommonMark 的快捷鍵列表可能會有幫助。

你能用 Markdown 作什麼

Markdown 可讓你寫任何你想寫的東西，僅需一次編輯，就能夠把它轉換成幾乎任何你想使用的格式。下面的示例演示如何將用 MD 編寫簡單的文本並轉換爲不一樣的格式。你不須要多種格式的文檔-你能夠僅僅編輯一次…而後擁有無限可能。

一、簡單的筆記：你能夠用 Markdown 編寫你的筆記，而且在保存筆記時，開源筆記應用程序 Turtl 將解釋你的文本文件並顯示爲對應的格式。你能夠把筆記存儲在任何地方!

Turtl application

二、PDF 文件：使用 Pandoc 應用程序，你可使用一個簡單的命令將 Markdown 文件轉換爲 PDF：

pandoc <file.md> -o <file.pdf>
複製代碼

Markdown text converted to PDF with Pandoc

三、Email：你還能夠經過安裝瀏覽器擴展 Markdown Here 將 Markdown 文本轉換爲 html 格式的電子郵件。要使用它，只需選擇你的 Markdown 文本，在這裏使用 Markdown 將其轉換爲 HTML，並使用你喜歡的電子郵件客戶端發送消息。

Markdown text converted to email with Markdown Here

如今就開始上手吧

你不須要一個特殊的應用程序來使用 Markdown，你只須要一個文本編輯器和上面的技巧。它與你已有的寫做方式兼容；你所須要作的就是使用它，因此試試吧。

---

via: opensource.com/article/19/…

做者：Juan Islas 選題：lujun9972 譯者：qfzy1233 校對：wxy

本文由 LCTT 原創編譯，Linux中國 榮譽推出