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

相關文章