MarkDown 的常用高階教程

iamxiarui_發表於2018-07-02

寫在前面

接觸 Markdown （以下用 MD 代替）已經有快兩年，最早接觸時震撼於其強大的書寫格式，現在已經養成日常的文件編輯習慣。比如現在公司的程式碼規範、入職指南、內部平臺教程與需求文件，我全部用 MarkDownPad 2 編寫，然後轉成 HTML 格式，閱讀的人無不稱讚其格式的優雅，而且更大的好處是從源頭上杜絕了由於 Office 版本（甚至是想不開用 WPS ）相容問題造成的文件格式變化問題，更重要的是 HTML 可以直接存入瀏覽器書籤，再也不用在資源管理器找來找去了。當然如果你安裝了 Everything 的話，當我沒說。

話說回來，在 IT 行業，應該很少有人不知道 MD 格式的吧。MD 的基本語法大家都能熟練掌握，但是有些非常常用的進階語法或者說小技巧不見得每個人都知道，所以現在就來說幾種不僅進階且非常常用的 MD 語法吧。以下是文章目錄：

常用高階語法

表格的使用

第一個比較常用的語法就是表格，網上也有很多教程，現在就來總結一下。它的語法如下：

|第一列|第二列|第三列|
|:-:|:-|-:|
|第一列是居中的|第二列是居左的|第三列是居右的|
複製程式碼

可以看出其實最重要的是|:-:|:-|-:| 這一行，如果要寫表格，此行不可以省略，也就是說必須要寫，但怎麼寫在於表格所需要的格式。

1、列名稱

首先如果此行上面不寫的話，那就沒有表列名稱，比如：

|:-:|:-|-:|
|第一列是居中的|第二列是居左的|第三列是居右的|
複製程式碼

沒有列名

簡書不支援不寫列名的表格，所以我截圖了，可以與上面的表對比看出，現在的表沒有了每一列的名稱，一般來說，都是需要寫的，注意，列名已經預設字型加粗了。

2、內容位置

細心的同學可能發現第二行中間有很多冒號，沒錯這就是控制表中內容是居中、居左還是居右的語法。可以把冒號看成是表的單元格的邊界，而短橫線相當於表單元格中的內容，比如：

  • :-: : 相當於內容被左右兩個邊界包裹，這就是居中
  • :- : 相當於內容靠近左邊界，這就是居左
  • -: : 相當於內容靠近右邊界，這就是居右

現在看之前的表格就清楚多了吧，表格語法就是這麼簡單。

3、注意事項

  • 有的教程裡面把短橫線畫了很多，其實沒有必要，只需要一個就行了，甚至居中 :-: 中的短橫線都可以省略。
  • Github 上面的 README.md 中必須要寫短橫線，不然識別不出來。
  • 用 MarkDownPad 2 軟體寫表格的話，記得把處理器改成擴充套件，不然沒有效果。

擴充套件

頁內連結跳轉

啥叫頁內連結跳轉呢，其實就是文章開頭的目錄，點選章節名，可以在頁內跳轉。那應該如何實現呢？

先說一下，其實 MD 就是一種標籤格式語言， HTML 所具備的一些格式， MD 同樣相容。比如下面的兩條語法其實是一樣的，同樣代表二級標題：

##測試標題
<h2>測試標題</h2>
複製程式碼

此外我們知道 MD 中連結的格式是 []() ，前面的中括號是標題，後面的小括號是連結。假如實現頁內跳轉的話，連結一定是頁內連結，那該如何寫呢。注意在 HTML 中，標題可以設定其 id 屬性，也就是這樣 <h2 id=""></h2> ，這個 id 恰好就是我們需要的頁內連結。

好了，來看具體寫法：

* [寫在前面](#1)
* [常用高階語法](#2)
	* [表格的使用](#3)
	* [頁內連結跳轉](#4)
	* [本地檔案連結](#5)
* [高效率軟體推薦](#6)
* [參考資料](#7)

<h2  id="1">寫在前面</h2>
<h2 id="2">常用高階語法</h2>
<h3 id="3">表格的使用</h3>
<h3 id="4">頁內連結跳轉</h3>
<h3 id="5">本地檔案連結</h3>
<h2 id="6">軟體推薦</h2>
<h2 id="7">參考資料</h2>
複製程式碼

可以看到在目錄中後面的連結寫法是 # + 標號 ，這個標號其實就是標題中的 id ，只要一一對應起來，就可以實現頁內跳轉了，是不是很簡單呢？效果就不展示了，文章已經使用了這種方式，大家可以試一試。

本地檔案連結

從上面可以學到如何實現頁內連結跳轉，那如何實現本地檔案連結呢，也就是如何點選後開啟本地資料夾呢，這個就比較簡單了，看下面的寫法就懂了：

[部落格檔案路徑](file:///F:/部落格/md)
複製程式碼

沒錯就是在檔案或資料夾的路徑前面加上file:///就行了，注意路徑為檔案或資料夾的絕對路徑，而且反斜槓需要轉義，這個應該很好理解吧，不再解釋。

這個語法的使用場景不多，畢竟每個人的資料夾路徑不一樣，主要使用在公司的共享資料夾中，能快速定位到目錄，方便快捷。

軟體推薦

好了，就介紹這三個常用的語法，其他的高階語法使用不多，如果有需求的話，可以閱讀官方文件或者看後面比較好的參考資料。現在來介紹幾款非常好用且提高效率的軟體。

Typora

眾多 Markdown 編輯器中的清流

Typora

  • 簡潔、好看、好用
  • 書寫實時顯示格式
  • 可免費匯出 PDF

所寫即所得

寫簡歷的時候，再也不用再網上轉換了，直接轉就行了，非常好用。官網安裝教程與中文詳細介紹在這：

Typora 官網

yiekue - 安利一下Typora：極致簡潔的markdown編輯器

Everything

瞬間給你想要

  • 安裝包極小，佔用記憶體極低
  • 快捷鍵瞬開，平時感受不到存在
  • 毫秒級搜尋，秒殺 Windows 資源管理器搜尋

瞬搜

這個是真的方便，實在忘記某個檔案放在哪後，只要記一點檔名就行了，官網在這：

Everything 官網

參考資料

Markdown: Syntax 英文官方文件

Markdown 簡明中文版

陳滿iOS - 程式設計師修養·Markdown語法學習手冊

個人部落格：www.iamxiarui.com

原文連結：http://www.iamxiarui.com/?p=1096

相關文章