1. 程式人生 > >我的 MarkDown 學習筆記

我的 MarkDown 學習筆記

MarkDown 一種用於寫作的輕量級【標記語言】。它用簡潔的語法代替排版,而不像一般的文書處理軟體 Word 或者 Pages 有大量的排版、字型設定等。

如果你對文章的樣式沒有太多要求,只注重寫文章本身的話 MarkDown 將會是一個不錯的選擇。

一、工具

支援 MarkDown 寫作的軟體有很多,因為國外平臺的國內訪問大都不太穩,這裡就列舉幾個國內常用的:

  • 簡書 部落格平臺,書寫的時候每隔幾秒鐘就會自動備份一次,需要註冊才能使用。

  • 馬克飛象 付費軟體,對於映像筆記使用者來說是個不錯的選擇。

  • Cmd MarkDown 作業部落的產品,跨平臺,支援 Windows、Linux、Mac 和 Web。而且提供了備份等功能。

  • Atom 著名的 Github 推出的編輯器,功能強大,支援原生實時預覽。實時預覽快捷鍵 ctrl+shift+m 。

二、基本語法

MarkDown 對於標題呀、字型呀等可能有多種寫法。個人建議初學的時候記憶一種語法就好,待熟練後若有興趣可多記幾種。

1.標題

MarkDown 支援 1~6 級標題,通過加在標題文字前的 # 來區分。例如,

# 這是一級標題
## 這是二級標題
...
###### 這是六級標題

Tips: # 和標題文字之間是有一個空格的。

2.段落

很簡單,一行文字就是一個段落。例如,

這是一行文字,MarkDown 中的段落。

如果要換行,那麼兩行之間要隔一個空行。例如,

這是一行文字,MarkDown 中的段落。
                               //這行是空行
這是另一行文字,MarkDown 中的段落。

3.粗體和斜體

Markdown 中字型的粗體和斜體用 * ** 表示。例如,

*這裡是斜體*
**這裡是粗體**
***這裡是粗體 + 斜體***

效果如下:

這裡是斜體

這裡是粗體

這裡是粗體 + 斜體

4.刪除線

可能有一部分編輯器不支援這個元素。刪除線用 ~ 定義。例如,

~~這裡有刪除線~~

效果如下:

這裡有刪除線

Tips: 刪除線要用兩個 ~ 來包裹文字。

5.引用

在一行文字前新增大於號 > 來使用引用格式。例如,

>這裡是引用句子。

效果如下:

這裡是引用句子。

引用可以巢狀使用,例如:

>>這裡使用了巢狀引用。

效果如下:

這裡使用了潛逃引用。

也可以巢狀其他格式。例如,

> ## 巢狀一個二級標題。
> *巢狀斜體字。*
> **巢狀粗體字。**

效果如下:

巢狀一個二級標題。

巢狀斜體字。

巢狀粗體字。

6.列表

列表分為無序列表和有序列表。

無序列表使用加號、減號和星號來標記。例如,

+ 加號列表
+ 加號列表
+ 加號列表

+ 減號列表
+ 減號列表
+ 減號列表

+ 星號列表
+ 星號列表
+ 星號列表

效果如下:

  • 加號列表
  • 加號列表
  • 加號列表

  • 減號列表

  • 減號列表
  • 減號列表

  • 星號列表

  • 星號列表
  • 星號列表

有序列表使用數字加上英文句點標記。

1.有序列表
2.有序列表
3.有序列表

7.內聯程式碼

內聯程式碼用反引號 ` 表示。例如,

`code`

有的地方說用單個 ` 即可表示內聯程式碼,由於我用的是 Atom 編輯器,
單個 ` 不起作用,只好用兩個 ` 將程式碼包裹起來。如果程式碼中有反引號 ` ,
也可以兩個反引號將它包裹起來,但是要加空格。例如,

` ` `

效果如下:

code

`

8.程式碼塊

有兩種風格,原生和 Github 。

原生風格,首行縮排四個空格。例如,

這是一個普通段落。

    這是一個程式碼塊。

效果如下:

這是一個普通段落。

這是一個程式碼塊。

Github 風格,程式碼塊的前後用三個反引號獨佔一行來標記。效果如下,

這裡是程式碼塊。

9.分割線

分割線可以用三個以上的星號、減號或者底線來標識,行內不能有其他東西,但是可以插入空格。例如,

***

* * *

---

- - -

___

_ _ _

效果如下:

10.連結

連結用下面的格式標識。例如,

[連結要顯示的文字](http://www.zhihu.com "滑鼠箭頭放到連結上的提示文字,可以不寫,與連結之間留有空格")

效果如下:

還可以用另外的格式標識,

[連結要顯示的文字][id]

在任意空白位置,

[id]:http://www.zhihu.com "滑鼠箭頭放到連結上的提示文字,可以不寫,與連結之間留有空格"

效果也是一樣的,

11.自動連結

如果連結的地址和要顯示的文字一樣的話,可以用尖括號將其包裹形成自動連線。例如,

<http://www.zhihu.com>

效果如下:

12.圖片

圖片的標識與連結類似。語法如下,

![圖片不存在時的提示文字](http://images.cnblogs.com/cnblogs_com/zhangyn/922022/o_%e6%89%8b.jpg "滑鼠箭頭放到圖片上的提示文字")

效果如下:

圖片不存在時的提示文字

圖片不存在時的提示文字
圖片的 MarkDown 標識與 HTML 標籤有對應的關係,關係如下,

![img alt 屬性](img 地址 “img title 屬性”)

<img src='img 地址' alt='img alt 屬性' title='img title 屬性'>

13.轉義

支援在前面插入反斜槓轉義的字元如下,

\           反斜線
`           反引號
*           星號
_           底線
{}      花括號
[]      方括號
()      括弧
#           井字號
+           加號
-           減號
.           英文句點
!           驚歎號

效果如下:

\ 反斜線

` 反引號

* 星號

_ 底線

{} 花括號

[] 方括號

() 括弧

# 井字號

+ 加號

- 減號

. 英文句點

! 驚歎號

14.表格

原本是 Github 風格的語法,大部分編輯器都支援。

| 鍵 | 值 | 備註 |
|----|----:|:------:|
|MacBookPro|¥12000|辦公用品|
|印表機|¥12000|辦公用品|
|臺式電腦|¥12000|辦公用品|

效果如下:

備註
MacBookPro ¥12000 辦公用品
印表機 ¥1200 辦公用
臺式電腦 ¥120

Tips:第一行表頭可以不要,第二行必須要有,第二行的冒號標識表中內容居左、居右還是劇中,如果不加冒號預設居左。

15.內嵌 HTML

MarkDown 保留了內嵌 HTML 的語法,標籤中的內容都會輸入到結果中。例如,

<html>
  <body>
    <div>
        <iframe frameborder="no" border="0" marginwidth="0" marginheight="0" width=330 height=86 src="//music.163.com/outchain/player?type=2&id=64517&auto=0&height=66">
        </iframe>
      </div>
   </body>
</html>

效果如下:




16.目錄

只要按照 MarkDown 語法書寫,在需要生成目錄的地方寫[TOC] 就可以生成目錄了。

三、綜述

至此,就可以用 MarkDown 來寫一般的文章啦。當然,如果有特殊的需求,比如:輸入公式或者畫 UML 圖,那麼可以參考下面的連結: