Markdown語法整理

Markdown語法整理

• 目錄

  • 6.1.豎杠|下劃線-寫法

  • 6.2.htmltable寫法

  • 5.1.無需列表

  • 5.2.有序列表

  • 5.3.定義型列表

  • 5.4.列表縮進

  • 5.5.包含段落的列表

  • 4.1.頁內超鏈接

  • 4.2.文章內部標題鏈接

  • 3.1.行內式:

  • 3.2.參考式

  • 3.3.自動連接

  • 一.分級目錄

  • 二.斜體與粗體

  • 三.超鏈接

  • 四.錨點

  • 五.列表

  • 六.表格

說明：本文中中語法里面的代碼就是需要寫的Markdown語法，展示效果就是最后生成的頁面
此語法編寫和測試環境：windows上使用MarkdownPad2的GitHub風格的Markdown語法

一.分級目錄

語法：

* 總目錄
  * 一級目錄
    * 二級目錄
      * 三級目錄

說明：層級列表一般只支持三級列表，第一級實心圓點，第二級空心圓點，第三級以后都是實心方點。要實現層級列表，每下一級都要比上一級多輸入2個空格或者一個Tab，而且第一級前面不要超過3個空格.

展示效果：

• 總目錄

  • 二級目錄

  • 三級目錄

  • 一級目錄

二.斜體與粗體

語法：

*斜體*
**粗體**

展示效果：

斜體
粗體

三.超鏈接

Markdown支持兩種形式的鏈接語法：行內式和參考式，行內式一般用的比較多。

3.1.行內式：

語法：

    [打開百度](http://www.baidu.com)
    [打開百度](http://www.baidu.com "打開百度")

說明:[]里寫鏈接文字，()里寫鏈接地址, ()中的”“中可以為鏈接指定title屬性，title屬性可加可不加。title屬性的效果是鼠標懸停在鏈接上會出現指定的 title文字。[鏈接文字](鏈接地址 “鏈接標題”)這樣的形式。鏈接地址與鏈接標題前有一個空格。

展示效果:

打開百度
打開百度

3.2.參考式:

參考式超鏈接一般用在學術論文上面，或者另一種情況，如果某一個鏈接在文章中多處使用，那么使用引用 的方式創建鏈接將非常好，它可以讓你對鏈接進行統一的管理。

語法:

  我經常瀏覽的幾個網站[Google][1]、[Baidu][2]、[51CTO][3]和看視頻的網站[愛奇藝][4]感覺都是很不錯的[網站][].
  [1]:http://www.google.com "google"
  [2]:http://www.baidu.com "Baidu"
  [3]:http://www.51cto.com "51cto"
  [4]:http://www.aiqiyi.com "aiqiyi"
  [網站]:http://www.qq.com

展示效果：

我經常瀏覽的幾個網站Google、Baidu、51CTO和看視頻的網站愛奇藝感覺都是很不錯的網站.

3.3.自動連接：

語法：

   <http://www.baidu.com/>
   <admin@baidu.com>

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

展示效果：

http://www.baidu.com/

admin@baidu.com

四.錨點

網頁中，錨點其實就是頁內超鏈接，也就是鏈接本文檔內部的某些元素，實現當前頁面中的跳轉。比如我這里寫下一個錨點，點擊回到目錄，就能跳轉到目錄。 在目錄中點擊這一節，就能跳過來。還有下一節的注腳。這些根本上都是用錨點來實現的。

注意：Markdown Extra 只支持在標題后插入錨點，其它地方無效

4.1.頁內超鏈接:

語法：

# 1.分級目錄{#index}
  跳轉到[標題]{#index}

說明：在你準備跳轉到的指定標題后插入錨點{#標記}，然后在文檔的其它地方寫上連接到錨點的鏈接。此處使用的是GitHub風格的Markdown語法所以無法正常顯示效果，推薦使用以下4.2.文章內部標題鏈接。

展示效果：

1.分級目錄{#index}

跳轉到1.分級目錄

說明：這里是在本文的分級目錄設置的，不然效果不明顯

4.2.文章內部標題鏈接：

語法：

* [目錄1](#20)
   * [標題1](#21)
   * [標題2](#22)
   * [標題3](#23)
   * [標題4](#24)

<h4 id='21'>標題1</h4>
    輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
<h4 id='22'>標題2</h4>
    正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
<h4 id='23'>標題3</h4>
    我輕輕的招手， 作別西天的云彩。
<h4 id='24'>標題4</h4>
    作別西天的云彩。

展示效果：

• 目錄

  • 標題1

  • 標題2

  • 標題3

  • 標題4

標題1

輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。

標題2

正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。

標題3

我輕輕的招手， 作別西天的云彩。

標題4

作別西天的云彩。

五.列表

5.1.無需列表:

使用 *，+，- 表示無序列表

語法：

    - 無序列表一
    + 無序列表二
    * 無序列表三

展現效果：

• 無序列表一

• 無序列表二

• 無序列表三

5.2.有序列表：

有序列表則使用數字接著一個英文句點

語法：

    1.有序列表一
    2.有序列表二
    3.有序列表三

展現效果：

1. 有序列表一

2. 有序列表二

3. 有序列表三

5.3.定義型列表:

語法：

  Markdown
  :    輕量級文本標記語言，可以轉換成html，pdf等格式（左側有一個可見的冒號和四個不可見的空格）
  代碼塊 2
  :    這是代碼塊的定義（左側有一個可見的冒號和四個不可見的空格）
    代碼塊（左側有八個不可見的空格）

說明：
定義型列表由名詞和解釋組成。一行寫上定義，緊跟一行寫上解釋。解釋的寫法:緊跟一個縮進(Tab)

展現效果：

Markdown
: 輕量級文本標記語言，可以轉換成html，pdf等格式（左側有一個可見的冒號和四個不可見的空格）

代碼塊 2
: 這是代碼塊的定義（左側有一個可見的冒號和四個不可見的空格）

    代碼塊（左側有八個不可見的空格）

5.4.列表縮進：

語法：

    *   輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
    那河畔的金柳， 是夕陽中的新娘； 波光里的艷影， 在我的心頭蕩漾。
    軟泥上的青荇， 油油的在水底招搖； 在康河的柔波里， 我甘心做一條水草！
    *   那榆蔭下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻間， 沉淀著彩虹似的夢。
    但我不能放歌， 悄悄是別離的笙簫； 夏蟲也為我沉默， 沉默是今晚的康橋！
    悄悄的我走了， 正如我悄悄的來； 我揮一揮衣袖， 不帶走一片云彩。

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

效果：

• 輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
  那河畔的金柳， 是夕陽中的新娘； 波光里的艷影， 在我的心頭蕩漾。
  軟泥上的青荇， 油油的在水底招搖； 在康河的柔波里， 我甘心做一條水草！

• 那榆蔭下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻間， 沉淀著彩虹似的夢。
  但我不能放歌， 悄悄是別離的笙簫； 夏蟲也為我沉默， 沉默是今晚的康橋！
  悄悄的我走了， 正如我悄悄的來； 我揮一揮衣袖， 不帶走一片云彩。

5.5.包含段落的列表：

語法：

  *   輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
  那河畔的金柳， 是夕陽中的新娘； 波光里的艷影， 在我的心頭蕩漾。
  軟泥上的青荇， 油油的在水底招搖； 在康河的柔波里， 我甘心做一條水草！

      那榆蔭下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻間， 沉淀著彩虹似的夢。
  尋夢？撐一支長篙， 向青草更青處漫溯； 滿載一船星輝， 在星輝斑斕里放歌。
  但我不能放歌， 悄悄是別離的笙簫； 夏蟲也為我沉默， 沉默是今晚的康橋！
  *    悄悄的我走了， 正如我悄悄的來； 我揮一揮衣袖， 不帶走一片云彩。

說明：
列表項目可以包含多個段落，每個項目下的段落都必須縮進 4 個空格或是 1 個制表符（顯示效果與代碼一致）：如果你每行都有縮進，看起來會看好很多，當然，再次地，如果你很懶惰，Markdown 也允許

效果：

• 輕輕的我走了， 正如我輕輕的來； 我輕輕的招手， 作別西天的云彩。
  那河畔的金柳， 是夕陽中的新娘； 波光里的艷影， 在我的心頭蕩漾。
  軟泥上的青荇， 油油的在水底招搖； 在康河的柔波里， 我甘心做一條水草！

  那榆蔭下的一潭， 不是清泉， 是天上虹； 揉碎在浮藻間， 沉淀著彩虹似的夢。
  尋夢？撐一支長篙， 向青草更青處漫溯； 滿載一船星輝， 在星輝斑斕里放歌。
  但我不能放歌， 悄悄是別離的笙簫； 夏蟲也為我沉默， 沉默是今晚的康橋！

• 悄悄的我走了， 正如我悄悄的來； 我揮一揮衣袖， 不帶走一片云彩。

六.表格

6.1.豎杠|下劃線-寫法:

語法：

  |名字|性別|年齡|國籍|
  |-----------------|
  |張三|男|23|中國|
  |小紅|女|18|中國|
  |Tom|男|46|美國|

展現效果：

6.2.htmltable寫法：

語法：

 <table>
       <tr>
           <td>車次</td>
           <td>開車時間</td>
           <td>到達時間</td>
        </tr>
        <tr>
            <td>D110</td>
            <td>10:22</td>
            <td>11:00</td>
        </tr>
 </table>

展現效果：

說明：這里有點奇怪，為什么那么大空格，目前沒有找到原因，跳轉至首頁

因為Markdown語法簡潔明了，在日常整理文檔時很不錯，就網上搜索，經過自己整理驗證，貢獻出來，以便需要的網友們參考，如果文檔中有錯誤的，或者看著不明了的，希望留言，以便糾正