教你使用Markdown寫部落格

摘要： Markdown基本語法 標題 ＃——###### 分別代表 h1--h6 比如 #### text text 區塊引用 1.可以在每一行都加上引用，也可以只在段落之前加上引用 > 這裡填寫要引用的文字 2.區塊引用可以巢狀 >> ...

Markdown基本語法

標題

＃——###### 分別代表 h1--h6
比如 #### text

text

區塊引用

1.可以在每一行都加上引用，也可以只在段落之前加上引用
> 這裡填寫要引用的文字
2.區塊引用可以巢狀
>> 這裡填寫要巢狀的文字
3.區塊內部也可以使用其他語法
> #### text

列表

無序列表

*號之前加上製表符會有多級效果

* 蘋果
* 香蕉
* 梨

*另外： + - 三者效果相同**

• 蘋果
• 香蕉
  • 梨

有序列表

使用數字加上英文句點
1. 蘋果
2. 香蕉
3. 梨
6. 草莓

另外注意一點，列表標記的數字並不會影響結果，即使是亂序排列，Markdown也會自動排序成有序的

1. 蘋果
2. 香蕉
3. 梨
4. 草莓

其他

• 強制換行，在語句後面加上兩個空格
• 用markdown語法時，在關鍵字元後面儘量加上空格，不然可能語句會不生效，例如 # text

Markdown及擴充套件

標記語言

> Markdown 是一種輕量級標記語言，它允許人們使用易讀易寫的純文字格式編寫文件，然後轉換成格式豐富的HTML頁面。
—— <a href="https://zh.wikipedia.org/wiki/Markdown" target="_blank"> [ 維基百科 ]

Markdown 是一種輕量級標記語言，它允許人們使用易讀易寫的純文字格式編寫文件，然後轉換成格式豐富的HTML頁面。—— <a href="https://zh.wikipedia.org/wiki/Markdown" target="_blank"> [ 維基百科 ]

字型，連結

使用簡單的符號標識不同的標題，將某些文字標記為**粗體**或者*斜體*，建立一個[連結](http://ibat.xyz)等

使用簡單的符號標識不同的標題，將某些文字標記為粗體 或者斜體 ，建立一個連結 等

表格

Markdown表格語法：

專案| 價格
-------- | ---
Computer | $1600
iPhone| $12
iPad| $1

專案	價格
Computer	$1600
iPhone	$12
iPad	$1

可以使用冒號來定義對齊方式：

| 專案|價格 | 數量|
| :-------- | --------:| :--: |
|左對齊|右對齊|居中 |
| Computer| 1600 元 |5|
| iPhone|12 元 |12|
| iPad|1 元 | 234|

專案	價格	數量
左對齊	右對齊	居中
Computer	1600 元	5
iPhone	12 元	12
iPad	1 元	234

程式碼塊

@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''

簡單的四個空格或者一個製表符生成程式碼塊

這裡放程式碼區塊

圖片

很明顯地，要在純文字應用中設計一個「自然」的語法來插入圖片是有一定難度的。

Markdown 使用一種和連結很相似的語法來標記圖片，同樣也允許兩種樣式： 行內式和參考式。

行內式的圖片語法看起來像是：

![Alt text]（/path/to/img.jpg）

![Alt text]（/path/to/img.jpg "Optional title"）

詳細敘述如下：

一個驚歎號 !
接著一個方括號，裡面放上圖片的替代文字（可以不填）
接著一個普通括號，裡面放上圖片的網址，最後還可以用引號包住並加上 選擇性的 'title' 文字。
參考式的圖片語法則長得像這樣：

![Alt text][id]

到目前為止， Markdown 還沒有辦法指定圖片的寬高，如果你需要的話，你可以使用普通的 <img> 標籤。

• 關於序列圖 語法，參考這兒 ,
• 關於流程圖 語法，參考這兒 .

先寫到這裡，有新的東西再繼續補充。