寫做利器 Markdown：基礎、編輯器及圖牀

1、寫做排版是個難題

寫做是每一個人平常生活和工做中必不可少的內容，不管是寫博客、寫郵件，仍是寫報告、寫接口文檔、寫項目方案文檔。

在使用 Word 或相似編輯工具寫做時，想必你必定糾結過字體、字號、間距等等的排版問題吧 ：）。

Word 這類富文本編輯工具，以所見即所得的方式，爲用戶提供了大量的可選樣式和排版支持。它的功能十分強大，樣式選擇也足夠自由，但也正是由於這樣，讓沒有經驗的用戶面對排版樣式的汪洋，不知所措：

• 一級標題用什麼字號什麼字體？
• 二級辯題用什麼字號什麼字體？
• 正文用什麼字號什麼字體？
• 正文與先後標題的邊距怎麼設定？
• 行間距，字間距，段落間距？
• ......

由此看來，想要讓文字排版成一篇看起來有模有樣的文章確實不是一件容易的事，不只須要掌握一些排版知識，也須要培養基本的排版審美。要是你向我同樣有強迫症那就慘了，不停地去調整比對，卻老是不盡人意 ：）。

那有沒有這樣一個模版，推薦一個好看的樣式，讓我不用關心各種字體、字號、間距等等的問題，而是能夠直接往裏頭套用？

試試 Markdown 吧。

2、Markdown 是什麼

Markdown 是一種標記語言。在寫做時，你的全部文字都是沒有樣式的純文本，在其中插入若干 Markdown 標記後，被標記的文字便有了樣式。樣式將會在渲染的時候呈現，而且樣式的顯示效果由 Markdown 工具決定。

好比，在你所寫的文字中，你但願某一行的最終排版呈現一級標題的樣式，那就給這行文字加個一級標題的標記；某個地方有兩個字須要加粗，那就給這兩個字加個粗體標記，最終的排版效果中這兩字就會是粗體模樣。

Markdown 支持對多種文章元素作標記，包括但不限於：

• 一至六級標題
• 粗體
• 斜體
• 引用
• 列表
• 圖片
• 表格
• 連接
• 代碼塊

當前這篇文章就是用 Markdown 寫的。你正在看的這部份內容的 Markdown 形式是這個樣子的：

Markdown 是一種標記語言。在寫做時，你的全部文字都是沒有樣式的純文本，在其中插入若干 Markdown 標記後，被標記的文字便有了樣式。樣式將會在渲染的時候呈現，而且樣式的顯示效果由 Markdown 工具決定。

好比，在你所寫的文字中，你但願某一行的最終排版呈現一級標題的樣式，那就給這行文字加個一級標題的標記；某個地方有兩個字須要加粗，那就給這兩個字加個粗體標記，最終的排版效果中這兩字就會是粗體模樣。

Markdown 支持對多種文章元素作標記，包括但不限於：

- 一至六級標題
- 粗體
- 斜體
- 引用
- 列表
- 圖片
- 表格
- 連接
- 代碼塊

這些內容通過渲染以後即是你所看的的效果。

3、Markdown 的使用方法

前面說了，Markdown 其實就是給文章內容做標記，把某處內容標記成什麼那它最終就呈現對應的樣式，而這些標記是一些簡單的符號。

那 Markdown 標記都有哪些，樣式效果是怎麼的呢？

經常使用的標記

(1) 二級標題

## 這是二級標題

這是二級標題

(2) 三級標題

### 這是三級標題

這是三級標題

(3) 四級標題

#### 這是四級標題

這是四級標題

(4) 粗體

這是**粗體**

這是粗體

(5) 引用

> 這是引用

這是引用

(6) 有序列表

Markdown 中列表有兩種：

1. 有序列表，像這樣帶序號的。序號以數字、點、空格組成
2. 無序列表，不帶序號的，也就是後面那種

Markdown 中列表有兩種：

1. 有序列表，像這樣帶序號的。序號以數字、點、空格組成
2. 無序列表，不帶序號的，也就是後面那種

(7) 無序列表

無序列表有兩種相同效果的寫法：

* 用 * 和一個空格開頭
- 用 - 和一個空格開頭

無序列表有兩種相同效果的寫法：

• 用 * 和一個空格開頭
• 用 - 和一個空格開頭

一個列表中咱們應該始終用同一種寫法，不用混用 * 和 -

(8) 連接

[這是連接文本](https://xx.xx/xx)

這是連接文本

(9) 插入圖片

![任意圖片名稱](https://xx.xx/xx)

加載成功時：

加載失敗時：

(10) 插入表格

| 表頭1 | 表頭2 |
| --- | --- |
| 單元格1 | 單元格2 |
| 單元格3 | 單元格4 |

表頭1	表頭2
單元格1	單元格2
單元格3	單元格4

不經常使用但可能會用到的標記

(1) 代碼塊

```python
print('代碼塊表示多行代碼，使用```來開頭和結尾代碼塊')
print('語言標識可選，如有則可自動高亮代碼元素')
```

print('代碼塊表示多行代碼，使用```來開頭和結尾代碼塊')
print('語言標識可選，如有則可自動高亮代碼元素')

(2) 行內代碼

這是行內代碼 `echo 行內代碼嵌入在某一行文本中

這是行內代碼 echo 行內代碼嵌入在某一行文本中

(3) 一級標題

# 這是一級標題

這是一級標題

(4) 五級標題

##### 這是五級標題

這是五級標題

(5) 六級標題

###### 這是六級標題

這是六級標題

(6) 分割線

---

---

(7) 斜體

這是*斜體*

這是斜體

(8) 刪除線

這是~~刪除線~~

這是刪除線

能渲染 Markdown 的編輯器

Markdown 是基於純文本的，因此你能夠直接使用記事本這樣的編輯器來寫做，可是記事本無法渲染 Markdown 內容，也就無法呈現出最終的排版效果。因此你須要一款能渲染 Markdown 內容的編輯器。

這裏爲你們推薦幾款免費編輯器：

• Typora，適合全部人，美觀，易用。（其官網的演示視頻 https://www.typora.io/img/bet...）
• VS code + markdownlint 插件，適合程序員

另外印象筆記、有道雲筆記之類的筆記產品和簡書之類的博客平臺也支持 Markdown 寫做和預覽。

圖牀

以前介紹了 Markdown 插入圖片的方式：

![任意圖片名稱](https://xx.xx/xx)

這裏演示的連接是網絡連接，其實也可使用本地圖片的的文件路徑，形式以下：

![任意圖片名稱](C:\Documents\sample.png)

若是你的文章只會在本地瀏覽，那麼連接使用本地圖片路徑沒有任何問題，可是若是文章須要分享給別人，或者須要在其餘電腦上瀏覽，那麼本地圖片路徑的方式就不行了，圖片會沒法正常加載。

一般狀況下建議使用網絡連接的方式來插入圖片。由於這種方式能夠跨設備，通用性更好。可是這會帶來一個問題：本身的圖片該如何上傳到網上，而且獲得網絡連接地址？

雲存儲做爲圖牀

咱們把網絡上用來保存上傳圖片的存儲叫作圖牀。

咱們可使用雲上的存儲服務做爲圖牀，好比阿里雲的 OSS、AWS 的 S3。雲存儲做爲圖牀有幾個好處：

• 穩定可靠
• 費用低廉甚至免費
• 學會以後可用做本身的文件備份系統

這裏以阿里雲 OSS （其雲存儲服務）做爲示例，簡單介紹下如何上傳圖片並獲得該圖片的網絡連接：

1. （僅第一次使用時） 首先在阿里雲官網（https://aliyun.com）註冊阿里雲帳號（可能須要實名認證），並登錄
2. 經過網址 https://oss.console.aliyun.com 進入 OSS 控制檯（若須要開通服務則選擇開通）
3. （僅第一次使用時） 找到並點擊右側的「新建 Bucket」按鈕，輸入一個未被佔用的名稱，「讀寫權限」選擇「公共讀」，其餘不變，而後「肯定」
4. 頁面左側列表中即可以看到你剛纔所設置的存儲空間名稱，點擊進入
5. 「文件管理」 -> 「上傳文件」 -> 「上傳文件」
6. 文件上傳後列表中會出現剛纔上傳的文件條目，點擊條目右側的「更多」 -> 「複製文件 URL」
7. 至此圖片已經上傳，而且它的網絡連接已經獲得，能夠在 Markdown 中使用了。值得注意的是，步驟 1. 和 3. 僅在第一次使用時才須要操做

結語

前面總共介紹了 18 種 Markdown 標記，其實經常使用的也就 10 種左右，這些標記符號都很簡單，不出二十分鐘便能所有記住。之後在寫做的時候請儘可能去使用 Markdown，一方面反覆的練習會使你緊緊記住各類標記符號，使用時信手拈來；另外一方面，Markdown 的使用會大大方便你寫做，減小排版帶來的負擔。請堅信 Markdown 會爲你帶來生產力的提高。

細心的讀者可能發現了，在介紹 Markdown 標記時，「一級標題」和「斜體」這麼常見的樣式被我列在了「不經常使用但可能會用到的標記」裏，這是怎麼回事？其實這兩種樣式雖然常見，可是按照 Markdown 的中文寫做規範，是不多被用到的。寫做規範是什麼？它定義了何時用粗體，何時用二級標題，何時必須加空格等等的要求，是個指導性的說明。

《寫做利器 Markdown：撰寫規範》將會爲你們介紹 Markdown 中文寫做規範。

---

微信訂閱「代碼以外的自我修養」，增刪改查以外來點有用且有趣的東西！