群分享：關於Markdown，你可能想知道的

阿新 • • 發佈：2022-05-03

寫在最前面的話

本文參考了很多大神的 Markdown 入門教程，旨在推廣，不標原創。所引部分參考文獻列於文末，如有疏漏，還請海涵。

文中介紹的 Markdown 語法為最常用的基礎語法，每種標籤的語法表達不止一種方式，這裡只選用了最常用的一兩種，更多語法格式請參考文末給出的官方文件連結內容。

本文用Markdown完成，想看 Markdown 原始檔的小夥伴請在後臺回覆「Markdown原始檔」獲取網盤下載連結。這是一篇小白科普文，有 HTML 基礎的都自己去看 Markdown 官方文件，別在這兒秀優越感。

認識 Markdown

小幻比較懶，這裡直接引用一下其他大神的說法。

Markdown是Aaron Swartz 跟John Gruber共同設計的一種輕量級「標記語言」

。Markdown 的理念是，讓文件更容易讀、寫和隨意改。它用簡潔的語法代替排版，而不像一般我們用的字處理軟體 Word 或 Pages 有大量的排版、字型設定。它使我們專心於碼字，用「標記」語法，來代替常見的排版格式。

Markdown 的輸出格式比較自由，可以是 HTML ，可以是 PDF 檔案，有些編輯工具甚至提供了Word檔案格式。這樣自由的輸出僅次於 LaTex ，而 Markdown 相對於 LaTex 的一大優點是，Markdown 是一門 5 分鐘就能夠學會的標記語言。LaTex需要多久，小幻不知道，因為小幻到現在都沒學會。

我們為什麼要用 Markdown

1. 避免編輯瘋掉

如果你有過給他人文件排版的經驗，尤其是那種把多個人的文件進行整合排版的經驗，你一定明白這個標題的意思。使用富文字（可以理解為帶格式的文字）編輯器得到的文件，在合併時，會出現很多排版上的問題。一一解決這些問題，十分費神。而這種問題，並不是大家使用統一的文書處理軟體例如 Word 就可以解決的，因為Word本身的版本差異，也會產生相容性問題。

這也是小幻會介紹 Markdown 的最初原因，我們的分享群每月都會進行一次文章彙總，幾十個人的文章分別釋出在不同的平臺上，彙總起來十分繁瑣。即使每個人都將自己的文章按照模板整合進 Word 文件中，最後的彙總者仍然面臨著大量的排版調整工作。

由於 Markdown 本身就是 txt，任何人都可以開啟它，並且因為它只是帶標記的純文字，本身不帶樣式，因此不會因為版本問題而產生很嚴重的樣式相容性問題。其次，Markdown 向 HTML 或者 PDF 轉換十分便捷。以上兩個特點，使得 Markdown 在網路文字編輯方面十分佔優勢。

Markdown提供一個標準化的格式，讓線上文字傳播更簡便。

2. 更加專注於寫作內容本身

Markdown 只是標記語言，當它轉換為 HTML 時，控制排版的是 CSS 樣式檔案，同樣的 Markdown 文字配上不同的 CSS 樣式，會展現出不同的 HTML 排版風格。網上有大量的基於 Markdown 排版的CSS樣式檔案，我們找到自己喜歡的即可，不用自己去寫。因此對於寫作者來說，使用Markdown的好處比起其他格式來說，更能專注在寫作本身，將投入在排版上的精力節省下來，投入在寫作本身，提高寫作效率和創作體驗。

陽志平在《Markdown寫作淺談》時說到：

難以專心：寫Word文件的時候，我們經常浪費大量時間在Word本身上，特別是那80%我們用不到的功能。比如，找藉口，Word又出問題了；或者，又要升級了。其實，在內心偷笑，哈哈，可以偷懶了
浪費力氣在排版上：使用Word時，我們會花費大量力氣去排版，試圖讓文件變得漂亮一些。是粗體還是斜體，是宋體還是黑體，對創作來說，有那麼重要嗎？
難以自動的版本跟蹤：每一位自殺的寫作者的電腦文件裡面，都必然有一個Word文件，從V1.0到V20.0的無數版本（如何優雅地進行版本追蹤對於文科生來說，是一項進階技能）；
難以共同協作：想想你讓一位合作的編輯幫你改書有多麼痛苦，一個Word文件來，一個Word去，極其難用的修訂與審閱功能，你就理解了（此條適用於會批閱你文件的任何人，口頭批閱不算）；

Markdown幫助寫作者提高寫作效率，優化寫作體驗

Markdown 基本語法

Markdown 簡單在於，掌握幾項基本用法就可以順利的完成寫作任務，以下是幾乎所有介紹 Markdown 入門的文章都會提到的幾項基本語法。

標題
段落
加粗
斜體
塊引用
連結
圖片
列表
分割線

標題

在標題行的最前面加上#號（英文半形字元，後面提到的所有符號都為英文半形），幾個#號代表幾個標題，最多可以到6級標題。部分編輯器會在標題文字前後都加上數量相等的#，效果是一樣的。以下是樣例：

標題1

標題2

標題3

標題4

標題5

標題6

原始碼：

# 標題1

## 標題2

### 標題3

#### 標題4

##### 標題5

###### 標題6

段落

在希望分段的地方空一行，即為分段。兩段之間沒有空行不會分段，這個不舉例，自己試一下就好。

加粗

在希望加粗的文字前後加上**或者__效果相同，選用自己順手的符號即可。

這裡需要用粗體強調。

這裡需要用**粗體強調**。

斜體

在需要使用斜體的文字前後加上*或者_。

粗體是兩個星號，斜體是一個星號。

**粗體**是兩個星號，*斜體*是一個星號。

塊引用

在引用文字的第一行最前面加上一個>（像不像一個指示箭頭？），整段文字都會以縮排形式顯示。

例如：

Markdown是Aaron Swartz 跟John Gruber共同設計的一種輕量級「標記語言」。Markdown 的理念是，讓文件更容易讀、寫和隨意改。

> Markdown是Aaron Swartz 跟John Gruber共同設計的一種輕量級**「標記語言」**。Markdown 的理念是，讓文件更容易讀、寫和隨意改。

連結

在你想要加連結的文字前後用中括號[ ], 然後緊接著加上URL網址連結，前後用小括號括住。

例如：

群分享：避開時間黑洞的小策略

[群分享：避開時間黑洞的小策略](http://mp.weixin.qq.com/s?__biz=MzI1MDQwOTU2OA==&mid=2247484421&idx=1&sn=5acc4da388942475cc103194e18aaf8d&chksm=e983e30adef46a1c2ab8a13861ddc81a7f598b78c778de1720b1803db59aa3857e8a0449dc7e&scene=21#wechat_redirect)

備註：這一條對於寫公眾號的朋友有點兒難弄，因為微信嚴格限制個人訂閱號的連結引用。所以打算在公眾號裡使用Markdown的各位，知道有這麼回事兒就行，連結還是需要自己手動新增的。

圖片

新增圖片跟新增連結的方法差不多，格式是![圖片名](圖片超連結)，圖片要求提前上傳到公網可以訪問的空間，很多支援Markdown的線上編輯器會幫助作者通過視覺化操作上傳圖片，就容易很多。

(這張圖片是小幻的公眾號圖片)

Markdown插入圖片原始碼

![Follow](http://t.cn/RJ8yzcq)

備註：圖片裡是小幻打算給小組夥伴做的分享課，本文裡沒看明白的地方，可以去微課裡提問。

列表

Markdown裡只有兩種列表，有序列表與無序列表。有序列表每行前面是數字序號，無需列表是一個小符號。

有序列表是以（數字 + . + 空格）的格式來標記的，但是不需要數字有順序，甚至一樣也沒關係。無序列表可以使用星號，加號或者減號（*、+、-）建立，它們三者效果都是一樣的，但要注意符號與列表內容之間需要加空格。

有序列表示例

跟著小幻GTD：收集階段-日常收集 | 時間管理
跟著小幻GTD：收集階段-歸攏材料 | 時間管理
跟著小幻GTD：Newbie，你準備好了嗎？ | 時間管理
跟著小幻GTD：如何成為一隻 GTD newbie| 時間管理

1. 跟著小幻GTD：收集階段-日常收集 | 時間管理 1. 跟著小幻GTD：收集階段-歸攏材料 | 時間管理 1. 跟著小幻GTD：Newbie，你準備好了嗎？ | 時間管理 1. 跟著小幻GTD：如何成為一隻 GTD newbie| 時間管理

無序列表示例

跟著小幻GTD：檢查回顧-保障系統的有效執行 | 時間管理
跟著小幻GTD：組織整理-建立好清單 | 時間管理
跟著小幻GTD：處理階段－清空工作籃｜時間管理

* 跟著小幻GTD：檢查回顧-保障系統的有效執行 | 時間管理 * 跟著小幻GTD：組織整理-建立好清單 | 時間管理 * 跟著小幻GTD：處理階段－清空工作籃｜時間管理

分割線

要新增分割線非常簡單，直接在一個空行裡打上三個星號(***)或者三個下劃線(___)。

例如：

***

___

Markdown 編輯器

Markdown 編輯器有很多，以下推薦幾款使用比較廣泛的軟體。

Mac平臺：
- Mou (開源專案，目前似乎已停止維護？)
- MacDown（MacDown由開源專案Mou修改而來，這篇文章就是用MacDown寫的）
- ulysses（廣受好評的工具，但是收費，小幻買不起反正）
Windows平臺：推薦MarkdownPad（Win10系統使用時會遇到不能即時顯示 HTML 預覽的問題，安裝元件可解決）
Web平臺：
- 簡書（支援Markdown）
- Wordpress（通過安裝外掛支援Markdown）
- typora（全平臺，這個是被推薦的，小幻自己沒用過）
RStudio可作為寫作科技論文與R語言編輯器選擇，它是跨平臺的
markdown-here藉助Chrome外掛，將gmai寫作視窗變為Markdown線上寫作視窗
可以直接線上通過github撰寫與提交Markdown檔案，github有自動的版本跟蹤功能，不用擔心寫廢與找不到以前寫的

Markdown 進階

這裡只講一下進階的 Markdown 可以做什麼，其他的留待未來某天分享。

Markdown + GitHub（或者其他版本管理工具）解決文件共享與版本自動跟蹤問題
Markdown + R 解決科學文件寫作問題（可重現性，跨平臺性，支援LaTex公式）
更多的 Markdown 寫作技巧，參看陽志平的《Markdown寫作淺談》

參考文獻

這裡給出Markdown語法的官方文件以及連結，其中，中文文件的末尾還附帶了各個平臺的免費工具介紹

創始人 John Gruber 的 Markdown 語法說明
Markdown 中文版語法說明
Markdown 寫作淺談
Markdown 線上寫作速成
認識與入門Markdown

連結地址

[1]: http://daringfireball.net/projects/markdown/syntax

[2]: http://daringfireball.net/projects/markdown/syntax

[3]: http://www.yangzhiping.com/tech/r-markdown-knitr.html

[4]: http://joinwee.com/lesson/10

[5]: http://sspai.com/25137

--- END ---