我的 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 圖,那麼可以參考下面的連結: