在我的工作中,，我經(jīng)常要寫代碼、寫與代碼相配套的文檔,、創(chuàng)建網(wǎng)頁,、進行文本恢復(fù)項目。我在學(xué)校的時候還寫過幾篇正式的論文,，也包括寫課堂筆記,，幾乎每節(jié)課都寫。

我?guī)缀踉谖宜械膶懽髦卸际褂?Markdown,，它對我來說是一個節(jié)省時間的好工具,。

在這篇文章中，我將分享我使用 Markdown 的體會,。你將會了解以下內(nèi)容：

• 什么是 Markdown ,？
• 它是怎么工作的？
• Markdown 的基本語法和怎樣使用它們,。

什么是 Markdown ,？

假如你是 Markdown 新手，它是一個為網(wǎng)絡(luò)寫手轉(zhuǎn)換文本到 HTML 格式的工具,。Markdown 文檔遵循一種特定的語法,，容易閱讀和寫作。它們是純文本,，所以能夠通過電腦上的任何文本編輯器來創(chuàng)建,。然后這些文檔能夠轉(zhuǎn)換成網(wǎng)頁 —— 而網(wǎng)頁是用一個叫做 HTML 的語言標(biāo)記創(chuàng)建的。

Markdown 只是一種不必（即使知道怎么做）寫 HTML 代碼就能夠創(chuàng)建網(wǎng)頁的方式,。實際上,，如果你不轉(zhuǎn)換成 HTML 的話，Markdown 甚至是個對純文本格式化的好方法,。有人曾這樣對我描述 Markdown ：

“ 它不是所見即所得,，而是所見即所意”,。

然而,，Markdown 不只是一個簡單的格式化體系,，它也是一個純文本格式轉(zhuǎn)化到 HTML 的一個軟件工具。

這就是為什么語法很重要,。如果你想在網(wǎng)頁上起個標(biāo)題,，Markdown 將會基于你標(biāo)題前面的字符來創(chuàng)建。Markdown 的一些語法示例如截圖所示：

所以我怎樣才能使純文本文件轉(zhuǎn)換成 HTML 格式呢?

John Gruber 的 Markdown 是一個運行在命令行上的 Perl 腳本,。也就是說,，它可以讀取你創(chuàng)建的 Markdown 文本并用它來構(gòu)建網(wǎng)頁。

由于有 許多著名的編輯器可以為你做這個轉(zhuǎn)換,，我在這里盡量避免使用命令行,。不僅如此，許多這樣的編輯器會讓你寫下你的文本,，并同時向你展示網(wǎng)頁的樣子（稱為渲染）,。

Markdown 編輯器總的來說設(shè)置了兩幀：左邊部分是你要寫你文本的地方，右邊部分是用 HTML 語言顯示給你格式化后文本的樣子：

當(dāng)你用它滿意地完成你的寫作,，只需保存 Markdown 文件即可,。就像這樣，之后一旦你需要編輯和修改的時候,，你就會用到它,。文件保存后，你可以用編輯器將 Markdown 文檔導(dǎo)出為 HTML 格式的文檔,。

編輯器用你的 Markdown 作為參考創(chuàng)建網(wǎng)頁,。你的 Markdown 文檔在導(dǎo)出時不會修改，你仍然擁有源文檔,，同時創(chuàng)建一個獨立的,、新的 HTML 文檔（網(wǎng)頁），你可以把它放到一個網(wǎng)頁服務(wù)器上,。

注意：許多 Markdown 編輯器也可以將你的 Markdown 文檔導(dǎo)出為其他格式,，比如.doc、.docx和.pdf,。之后你可以了解這些高級設(shè)置和你可能需要的額外軟件,。

Markdown 基礎(chǔ)語法

為了讓 Markdown 新用戶快速了解，我將把這部分內(nèi)容限制在我最常使用的語法上,。我相信這些將是最有幫助的 - 你可以在現(xiàn)在就提高工作效率,，同時了解更多關(guān)于 Markdown 以后能為你做什么。

寫標(biāo)題

我經(jīng)常使用 #字符來表示標(biāo)題,。這里有六個等級：

還有一種標(biāo)題類型,，是在文本下使用下劃線,。我很少使用這種類型的標(biāo)題，我只限于使用兩種：一種是使用 =字符表示的雙下劃線,，生成H1標(biāo)題,。一種是使用-字符表示的單下劃線，生成H2標(biāo)題：

一級標(biāo)題===============二級標(biāo)題---------------

段落

段落被空行隔開（確保段落之間有一個空行）,。首行不要縮進,。在 Markdown 里用 Tab鍵或者空格鍵縮進有著不同的目的和作用。

段落是一個文本塊,，不應(yīng)該用空格鍵和 Tab鍵來縮進,。它可以有一行或者多行。要結(jié)束這一段另起一段,，點兩下回車鍵,；段落通過一個空行分開。

換行

請記住,，對于段落,，必須用空行來分隔它們，這要通過按兩次回車鍵來實現(xiàn),。Markdown 對此很嚴(yán)格,。

Markdown 不支持 “強制插入換行符hard-wrapped” 或者 “固定行長度fixed-line-length” 段落。那就是說,，單擊回車鍵一次將不會強制文本換到新的一行,。它可能在編輯窗口顯示，但是 HTML 格式下不顯示,。

然而,，有時你可能需要拆分段落或者換行。Markdown 確實有一種方法可以做到,，但是它一開始看起來可能有一點奇怪：換行是通過用兩到多個空格鍵然后點一次回車鍵完成的,。

這里有一個短詩的范例。每行以兩個空格結(jié)束,。最后一行,，由于是這個小節(jié)的結(jié)束，沒有額外的空格,。因為它是這個詩句（段落）的結(jié)束,，我雙擊回車鍵兩次：

在一行的最后加兩個空格來創(chuàng)建一個換行，可能需要時間去習(xí)慣,。

水平線

水平線非常適合將文本拆分為多個部分,。

用三個或更多的破折號 -，下劃線_，或者星號*來做水平線,，像這樣：

---***___

你甚至可以在字符之間輸入空格：

在文章和報告中我不經(jīng)常使用水平線,，但是在日記、系統(tǒng)日志和課堂筆記中對我很有用,。

用加粗和斜體來強調(diào)文本

當(dāng)你想讓一個單詞或者短語脫穎而出,，引起注意，你可以讓它加粗或者斜體顯示,。斜體和加粗文本可以在兩種方式中任選其一,。第一種是用星號 *將其包括,，第二種是用下劃線_的方式,。

使一個單詞或者短語斜體顯示，用一個下劃線或者星號來括住文本,。使一個單詞或者短語加粗,，使用兩個下劃線或者星號來括住文本：

用星號來顯示 *斜體* 。用下劃線來顯示 _斜體_ ,。用星號來顯示 **加粗** ,。用下劃線來顯示 __加粗__ 。

記住兩邊使用相同的字符,。單詞或短語的一面是星號,，另一面是下劃線，將不會生效,。相同字符必須在單詞或者短語的兩邊,。

塊引用

塊引用被用來直接引用。如果你正在寫博客,，你想重復(fù)本杰明·富蘭克林說過的話,，你可以使用塊引用。

一個右尖括號被用來指定塊引用：

在 Markdown 中添加超鏈接

超鏈接非?？?。在基礎(chǔ)版的 Markdown 語言有三種方式創(chuàng)建超鏈接，在這里我只講兩種：普通連接和自動連接,。

第三種鏈接被稱為參考鏈接,，在 Markdown 語言的基礎(chǔ)版和高級版都支持。我想讓你快速入門,。你可以在準(zhǔn)備好的時候找找參考鏈接的資料,。

普通鏈接可以讓你鏈接到各種各樣的網(wǎng)站。網(wǎng)站名稱或者你要使用的短語被放置在中括號 中。真實的鏈接地址在小括號中,。

現(xiàn)在去看看 [Linux 中國](https://) ,。

自動連接通過用尖括號 括住鏈接地址。這個鏈接是一個實際的地址（可以是網(wǎng)址或者電子郵件地址）,。拼寫出來的鏈接被轉(zhuǎn)換到 HTML 的時候,，就變成了有效的鏈接。

當(dāng)你想在文本中拼寫出網(wǎng)址時,，這很有用：

在 Markdown 中添加圖片

鏈接圖片幾乎與鏈接網(wǎng)站一樣,。網(wǎng)站鏈接和圖片鏈接微小的不同是，圖片鏈接以感嘆號 !開始,。

圖片名稱或者圖片描述放置在中括號 里,。實際鏈接放置在小括號里。

你可以像這樣嵌入圖片：

這兒有一個示例圖像鏈接,。這是一個示例鏈接,，沒有這個圖片，但是這是個好例子,，顯示了實際鏈接應(yīng)該有的樣子：

![a picture of bill](./images/my_photo_of_me.jpg)

列表

制作列表有很多原因,。它們可能用來作為代辦事項、大綱中的主題元素,、組裝項目中的明細(xì)欄等等,。列表有兩種主要類型：無序列表和有序列表。

無序列表沒有編號,；這些就是我們在許多文檔中所看到的列表項,。有序列表是有編號的。

要創(chuàng)建一個有序（有編號的）列表,，只需在每行用一個數(shù)字開始,，像這樣：

無序列表沒有編號，但要在列表每個項目的開始使用一個星號 *,、一個加號+,，或者一個減號-。我偏向于使用一個星號或者減號,，你可以選擇適合你的：

* 項目 一,。+ 項目 二。- 項目 三,。

子項目可以通過縮進被添加到有序和無序列表中,，像這樣：

Markdown 語法速查表

這是一個簡短的 Markdown 語法列表為你作為參考，這個列表已經(jīng)在本小結(jié)中介紹。

如果你決定使用 Markdown 作為寫作工具,，你會發(fā)現(xiàn) Markdown 會讓寫作變得更加簡單,。

下載 PDF 格式的 Markdown 速查表

結(jié)語

Markdown 可以做比我描述的更多的事情。我寫作的很大一部分是用我在這里介紹的 Markdown 語法完成的 - 而這些是我最常使用的項目,，即使是在更復(fù)雜的項目中,。

如果這些看起來太簡單了，那么說明它真的很容易,。Markdown 用來完成簡單的寫作任務(wù),，但是你不必完全聽我的。你可以嘗試一下,！不必安裝 Markdown 編輯器,；你可以在線嘗試。這里有幾個 優(yōu)秀的在線 Markdown 編輯器,。這里我喜歡用這三個：

• John Gruber’s Dingus
• Editor.md
• Dillinger

Editor.md和 Dillinger 會讓你看到你的 Markdown 文本作為 HTML 實時渲染的效果,。 Dingus 不能實時預(yù)覽，但是在參考頁有 Markdown 的語法速查表,。

用以上這些在線編輯器嘗試一下文章中的示例。也可以嘗試一下你自己的想法,。這將使你在可能致力于學(xué)習(xí)更多的知識之前習(xí)慣于 Markdown,。

via: https:///markdown-guide/