如有紕漏，敬請指出！謝謝~

Markdown的宗旨

目標是實現「易讀易寫」。一份使用 Markdown 格式撰寫的文件應該是可以直接以純文本發布，并且看起來不會像是由許多標簽或是格式指令所構成。Markdown 語法受到一些既有 text-to-HTML 格式的影響，其中包括 Setext、atx、Textile、reStructuredText、Grutatext 和 EtText。
Markdown語法全由一些符號所組成，這些符號經過精挑細選，其作用一目了然。
Markdown 并不是想要取代 HTML，甚至也沒有要和它相近，它的語法種類很少，只對應 HTML 標記的一小部分。

其理念是，能讓文檔更容易讀、寫和隨意改。HTML 是一種發布的格式，Markdown 是一種書寫的格式。

Markdown語法：參考網站

常用的插入 比較

• • 插入圖片
    輸入格式：名字+圖片URL

    效果：

    小貓喵
    
    
    

• • 插入文字鏈接
    輸入格式：名字+響應請求的URL

    效果：
    小貓喵: 點我，我就出來 ~
    
    

• • 插入圖片?文字鏈接
    輸入格式：名字+響應請求的URL+圖片的URL

    
    

    效果：
    圖片加鏈接：

    [圖片上傳失敗...(image-492b0b-1512543899471)]](http://upload-images.jianshu.io/upload_images/1870963-b570b8d26138b8d1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/800)

輸入格式 及 效果

1.文檔中插入一個版權符號 ?

輸入格式：

效果：?

2.標題

兩種標題的語法，類 Setext 和類 atx 形式。

• • 【一】、類 Setext 形式是用底線的形式
    輸入格式：

    效果：

    This is an H1

    This is an H2

• • 【二】、類 Atx 形式
• • • 在行首插入 1 到 6 個 “#” ，對應到標題 1 到 6 階
      輸入格式：
    
    

    效果：(階數 決定 大小)

    這是H1

    這是H2

    這是H3

• • • 選擇性地「閉合」類 atx 樣式的標題，這純粹只是美觀用的。（??行首的井字符??數量決定標題的階數）
      輸入格式：
    
    

    效果：

    這是H1

    這是H2

    這是H3

3.區塊引用 Blockquotes

輸入格式：

效果：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

也允許你??偷懶只在整個段落的??第一行最前面??加上 “>”。
輸入格式：

This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

• • 區塊引用可以嵌套
    輸入格式：

    效果：

    This is the first level of quoting.

    This is nested blockquote.

    Back to the first level.

• • 引用的區塊內也可以使用其他的 Markdown 語法
    包括：標題、列表、代碼區塊等……
    輸入格式：

    效果：

    這是一個標題。

    1. 這是第一行列表項。
    2. 這是第二行列表項。

    給出一些例子代碼：

    return shell_exec("echo $input | $markdown_script");
    

4.列表

• 【一】、無序列表
  使用星號、加號或是減號作為列表標記

  輸入格式：（三種）

  效果：

  • Red
  • Green
  • Blue

• 【二】、有序列表
  則使用數字接著一個英文句點

  1. Bird
  2. McHale
  3. Parish

  很重要的一點是，你在列表標記上使用的數字并不會影響輸出的 HTML 結果，上面的列表所產生的 HTML 標記為：

  
  

  你都會得到完全相同的 HTML 輸出。

  ??：重點在于，你可以讓 Markdown 文件的列表數字和輸出的結果相同，或是你懶一點，你可以完全不用在意數字的正確性。
  
  
  

特別演示

輸入格式：

效果：
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>

• • 列表項目標記通常是放在最左邊，但是其實也可以??縮進，最多 3 個空格，項目標記后面則一定要接著至少一個空格或制表符。

    輸入格式：

    
    

    效果：

    • Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
      Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
      viverra nec, fringilla in, laoreet vitae, risus.
    • Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
      Suspendisse id sem consectetuer libero luctus adipiscing.

• • 要在列表項目內放進引用，那 “>” 就需要縮進

    輸入格式：

    效果：

    • A list item with a blockquote:

      This is a blockquote
      inside a list item.

• • 要放入代碼區塊的話

    該區塊就需要縮進兩次，也就是 8 個空格或是 2 個制表符
    
    輸入格式：

    效果：

    • 一列表項包含一個列表區塊：

      <代碼寫在這>
      

• • 項目列表很可能會不小心產生，像是下面這樣的寫法：

    產生的效果：

    1986. What a great season.

    
    
    換句話說，也就是在行首出現數字-句點-空白。

    
    要避免這樣的狀況，你可以在句點前面加上反斜杠。

    改善后，新產生的效果：
    1986. What a great season.

5.代碼區塊

要在 Markdown 中建立代碼區塊很簡單，只要簡單地縮進 4 個空格??或是 1 個制表符??就可以了。

輸入格式：

效果：

這是一個普通段落：

這是一個代碼區塊。

在代碼區塊里面， “&” 、 “<” 和 “>” 會自動轉成 ??HTML 實體，這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼，只需要復制貼上，再加上縮進就可以了，剩下的 Markdown 都會幫你處理，例如：

輸入：

我們看到的效果：

<div class="footer">
? 2004 Foo Corporation
</div>

6.刪除線

兩個波浪線開頭，兩個波浪線結尾 放在中間的部分就被加上刪除線了!
譬如:此??，哈哈

輸入格式：

效果：
I Love You! It's Wrong!</br>
I Hate You!
It's True
Do you trust?

7.分隔線

可以在一行中用三個以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西。
也可以在星號或是減號中間插入空格。

輸入格式：

效果：

---

ads

---

goyohol

---

qp

---

sdfd（產生的字體 大一些）

8.區段元素

• 鏈接
  
  給個??：

  得到的效果
  文字鏈接：小貓喵: 點我吧！點我就讓你看哦 ~
  
  
  

詳細內容參考：Markdown語法說明(簡體中文)

9.強調

粗體和斜體

輸入格式：

會轉為:

效果：
single asterisks

single underscores

double asterisks

double underscores

• ??

  效果:
  unfriggingbelievable
  
  

  ---

  效果:
  *this text is surrounded by literal asterisks*

10.代碼

陰影效果： 兩個 “`”符號中間的內容注上陰影！

“`”符號輸出方式： (英文輸入模式)

保證在英文輸入模式

輸入"`" 的方式

操作鍵示意

效果：
Use the printf() function.

效果：
There is a literal backtick (`) here.

效果：
A single backtick in a code span: `
A backtick-delimited string in a code span: `foo`

效果：
— is the decimal-encoded equivalent of —.

(※※※※※ 同樣可以作用于 圖片的注釋 ※※※※※)
輸入格式：

`APPDelegate.h`.png

效果：
AppDelegate.h

11.圖片

• 【一】、行內式

  詳細敘述如下：
  一個驚嘆號 !
  接著一個方括號，里面放上圖片的替代文字
  接著一個普通括號，里面放上圖片的網址(??URL:統一資源定位符)，最后還可以用引號包住并加上 選擇性的 'title' 文字。
  
  

• 【二】、參考式

舉個??： 行內式
輸入格式：

效果：

小貓喵

12.自動鏈接

Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱，只要是用尖括號包起來， Markdown 就會自動把它轉成鏈接。一般網址的鏈接文字就和鏈接地址一樣。

效果：
goyohol個人主頁：http://www.lxweimin.com/users/0c0805f8de58/latest_articles

13.反斜杠

可以利用反斜杠來插入一些在語法中有其它意義的符號。
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號：

14.表格

輸入格式：

效果：

輸入格式：

輸入格式：

15.顯示鏈接中帶括號的圖片

有些使用到HTML的地方，可能已經改變了?。∷哉堉苯犹^無效的部分??！

但是至今不能使用?。∮悬c煩~~~

換行

最煩的是不能使用“</br>”換行！

不過聰明如我！自有妙計！

使用：

效果：

abc

efg

goyohol's essay