Markdown文法說明

標籤：

1. 概述
   • 宗旨:易讀易寫
   • 相容html:<div>,<table>等標籤在markdown裡面都可以直接用.要制約的只有一些區塊元素,要求:
     • 開始標籤和結尾標籤不能用空白符號來縮排
     • 必須在前面和後面加上空行,與其它內容分割開來
   • 特殊字元自動轉換
     • 在html檔案中,<必須轉義成&lt;(less than),>必須轉義成&gt;
     • &必須轉義成&amp;(and multiply)
     • 當然,html中還有好幾個類似的逸出字元,在markdown裡面可以直接寫<,>和&這三個東西,而無需轉義.其他的逸出字元如@copy;markdown的處理方式份html是一樣的,把它當做逸出字元.
2. 區塊元素
   • 段落和換行
     • 段落是由一個或者多個連續文本航組成的,它的前後要有至少一個空行.
     • 這意味著markdown支援段內換行,相當於插入分行符號.
   • 標題
     • 有兩種方式寫標題
       • ---------和=======,減號表示二階標題,等號表示一級標題
       • ###,六個#表示六級標題,一個#表示一級標題
   • 區區塊引述blockquote
     • 在每行前加幾個>就表示縮排多少
     • 在每個句子前面加幾個>就表示這句話縮排多少,只在段落開頭加就表示這整個段落縮排多少
   • 列表
     • 無序列表用*+-三種符號都行
     • 有序列表只要是數字加點就可以,例如  3.  23423.markdown並不會在意數字是幾,最終都是變成html的樣子.
     • 清單項目可以包含多個段落,每個段落要縮排4個空格或者一個定位字元.
     • 如果我想打2323.怎麼辦,答曰;2323\.
   • 代碼區塊
     • 相當於<pre><code>,在markdown中只需要縮排4個空格或一個定位字元就行了.
     • 一個代碼區塊會一直持續到沒有縮排的那一行（或是檔案結尾).
     • 代碼區塊中，一般的 Markdown 文法不會被轉換，像是星號便只是星號,不表示無序列表.
   • 分隔線
     • 三個以上星號,減號,底線+中間可以有若干個空格

• 區段元素
  • 連結
    • 有兩種:行內式和參考式
    • 直接用角括弧括起來就是連結

    • 要建立一個行內式的連結，只要在方塊括弧後面緊接著圓括弧並插入網址連結即可，如果你還想要加上連結的 title 文字，只要在網址後面，用雙引號把 title 文字包起來即可，例如：

      This is [an example](http://example.com/ "Title") inline link.[This link](http://example.net/) has no title attribute.

      會產生：

      <p>This is <a href="http://example.com/" title="Title">an example</a> inline link.</p><p><a href="http://example.net/">This link</a> has notitle attribute.</p>

    • 參考式的連結是在連結文字的括弧後面再接上另一個方括弧，而在第二個方括弧裡面要填入用以辨識連結的標記：

      This is [an example][id] reference-style link.

      你也可以選擇性地在兩個方括弧中間加上一個空格：

      This is [an example] [id] reference-style link.

      接著，在檔案的任意處，你可以把這個標記的連結內容定義出來：

      [id]: http://example.com/  "Optional Title Here"

    • 連結內容定義的形式為：

      • 方括弧（前面可以選擇性地加上至多三個空格來縮排），裡面輸入連結文字
      • 接著一個冒號
      • 接著一個以上的空格或定位字元
      • 接著連結的網址
      • 選擇性地接著 title 內容，可以用單引號、雙引號或是括弧包著

    • 下面這三種連結的定義都是相同：

      [foo]: http://example.com/  "Optional Title Here"[foo]: http://example.com/  ‘Optional Title Here‘[foo]: http://example.com/  (Optional Title Here)

    • 連結網址也可以用角括弧包起來：

      [id]: <http://example.com/>  "Optional Title Here"

      你也可以把 title 屬性放到下一行，也可以加一些縮排，若網址太長的話，這樣會比較好看：

      [id]: http://example.com/longish/path/to/resource/here    "Optional Title Here"

  • 強調
    • • 一個星號或者一個底線表示<em>
  • • • 兩個星號或者兩個底線表示<strong>
      • 用什麼符號開啟強調,就用什麼符號結束
      • 若要寫*或者_,需要轉義\*
      • 如果你的 * 和 _ 兩邊都有空白的話，它們就只會被當成普通的符號。
  • 行內代碼
    • 用反引號,相當於<code></code>
    • 若要寫出反引號,那就用
  • 圖片
    • • Markdown 使用一種和連結很相似的文法來標記圖片，同樣也允許兩種樣式： 行內式和參考式。

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

        ![Alt text](/path/to/img.jpg)![Alt text](/path/to/img.jpg "Optional title")

      • 參考式的圖片文法則長得像這樣：

        ![Alt text][id]

        「id」是圖片參考的名稱，圖片參考的定義方式則和連結參考一樣：

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

 

• • 其它
    • \ 反斜線
    • ` 反引號
    • * 星號
    • _ 底線
    • {} 花括弧
    • [] 方括弧
    • () 括弧
    • # 井字型大小
    • + 加號
    • - 減號
    • . 英文句點
    • ! 驚歎號

Markdown文法說明