github-pages裏的markdown語法和心得

此版本的jekyll搭載的markdown解釋器是kramdown-1.9，跟其餘markdown的解釋器可能會有一點差別

語法

1. 標題

書寫方式: ##、### + 空格 + 內容

## 大標題
### 小標題
#### 超小標題
超大標題   //等於號寫於文字下方
===
標題      //同超大標題
---

效果:

ps: 標題左側空格沒必要須,可是若是是要上傳到github做爲文章的話,則必需要有.

2.行內代碼

`這個符號在1的左邊`

這個符號在1的左邊

3. 引用

書寫方式: >、> > + 空格 + 內容

A.單層引用

>第一行>開頭+兩個空格換行
第二行沒必要再寫>

效果

第一行>開頭+兩個空格換行
第二行沒必要再寫>

B.疊層引用

> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.

效果

This is the first level of quoting.

This is nested blockquote.

Back to the first level.

4. 列表

A.無序列表

書寫方式 *、-、+ + 空格 + 內容

* Red
* Green
* Blue

- Red
- Green
- Blue

+ Red
+ Green
+ Blue

效果:(三種方式效果同樣)

• Red

• Green

• Blue

• Red

• Green

• Blue

• Red

• Green

• Blue

B.有序列表

書寫方式 數字 + 空格 + 內容

1. 這是第一個
 1. 這是第二個
 1. 這是第三個

效果:(會自動排序)

1. 這是第一個

2. 這是第二個

3. 這是第三個

5. 分割線

書寫方式: ***、---、\n +> + \n

* * *
***
*****
- - -
---

效果:

6. 超連接

書寫方式: [title](href)

[markdown-syntax](http://daringfireball.net/projects/markdown/syntax)

效果

markdown-syntax

以變量的方式定義超連接
書寫方式[var_name]: url "title"

[id]: http://example.com/  "Optional Title Here"
This is [an example][id] reference-style link.

效果:

This is an example reference-style link.

7. 強調(加粗，斜體)

書寫方式: *內容*、**內容**、_內容_、__內容__,

*內容*
**內容**
_內容_
__內容__

效果:

內容
內容
內容
內容

8. 圖片引用

書寫方式:![alt](圖片路徑)

![這是張圖片](/path/to/im)

效果:

這個跟超鏈同樣均可以設置定義變量

[id]: url/to/image  "Optional title attribute"
![hahah][id]

效果

9. 雜項

A.簡單超連接

<http://example.com/>

效果:

http://example.com/

B.簡單email地址

<xiazhichao75@126.com>

效果:

xiazhichao75@126.com

10. 代碼塊

書寫方式:四個空格 or Tab

四個空格
    一個tab

效果:

四個空格
一個tab

心得

由於以前看過SF的markdown解釋器的語法規則，當時我想，這都是markdown，語法應該都一個樣吧，結果照着SF的語法規則，行不通。下面我就來列一列他們之間的有哪些是不同的

1. 引用的換行

   SF的換行規則是另起一行+`>`
   
   GP的換行規則是在一行末尾+兩空格`  `+回車沒必要+`>`

2. SF沒法引用超大標題,爲了讓大家看到效果，我才截的圖,固然這可能沒什麼卵用

3. 分割線的使用方法，

   SF是---,***中間不可加空格
   GP是能夠在中間插空格的

4. SF沒法將<xiazhichao75@126.com>解釋成email

新手駕到，若有不足之處，還請指點，你們共同進步。

參考連接
http://kramdown.gettalong.org/converter/kramdown.html
http://daringfireball.net/projects/markdown/syntax