關(guān)于 Markdown

Markdown 語法的目標: 成為一種適用于網(wǎng)絡(luò)的書寫語言。

一、區(qū)塊標記

區(qū)塊標記： 是指內(nèi)容獨占一塊，需前后換行，不和其他標記共處一行的標記。

段落： 即是一段連續(xù)的文字，可包含*、空格、換行、tab等字符。兩個段落之間使用空行分隔。

標題： 代表了文章中主題的層次。
語法： Markdown 中使用連續(xù)的 n(1-6) 個 # 分別表示第 n 級標題。(注：# 和后續(xù)內(nèi)容之間應(yīng)放置一個空格)

列表： 就是一組相關(guān)信息的集合。簡書中的列表分為 有序列表 和 無序列表。
1) 有序列表語法：使用 數(shù)字 + . 作為項目符號，項目符號和正式列表項目之間有一個空格。

2) 無序列表語法：使用 + 、- 或 * 作為項目符號，項目符號和正式列表項目之間有一個空格。

• *無序列表的項目符號可使用 ,+,- 效果是相同的。
• 列表與后續(xù)內(nèi)容之間需要一個空行隔開，即：列表是一個段落
• 列表允許多層次嵌套
• 可以在項目中包含段落，只需將段落前添加一個 tab 或 4 個空格

3) 分割線語法：使用 3 個連續(xù)的 * 即可得到一個分割線。

4) 引用語法：在行頭加上 > 即可。

• 大于號 和 文字必須有一個空格
• 可以在每行之前加 > ，也可以在段落之前加 1 個 >
• 引用內(nèi)部可以使用其他 Markdown 標記
• 引用內(nèi)部可以添加新的引用，只需再加一個大于號

二、行內(nèi)標記

1) 斜體：使用前后各 1 個 ( _ 或 * ) 包含的文字是 斜體 文字。
2) 粗體：使用前后各 2 個 ( _ 或 * ) 包含的文字是 斜體 文字。
3) 刪除線：使用前后各 2 個 ~ 包含的文字是刪除文字。
4) 粗斜體：在 (或 _ ) 中嵌套 (或) 或 在 _ (或) 中嵌套 ** (或 _ ) 即可得到 粗斜體。

三、圖片

1)行內(nèi)圖片：圖片和圖片地址卸載一起。

• 語法：
  [圖片名稱] ( 圖片url )

2)引用圖片：圖片和圖片地址分開書寫。_

• 語法：
  ![圖片標題 image.png ][圖片id]
  [圖片id]:圖片url 。

四、鏈接

1) 行內(nèi)鏈接

• 語法：
  [鏈接名稱](鏈接 url “鏈接ttle")

2) 引用鏈接

• 語法：
  [鏈接名稱][鏈接id]
  [鏈接id]:鏈接 url "鏈接ttle"

注意事項：鏈接 id 可使用字母、數(shù)字、空格，但不區(qū)分大小寫。

3) 自動鏈接

• 一種簡明的鏈接書寫方式。
• 語法：<鏈接地址>

五、腳注

• 為名詞提供注釋，注釋將顯示在文章末尾。
• 語法：
  待注釋文字[^腳注 id]
  [^腳注 id]:注釋內(nèi)容
• 示例:

Hello May[^may]
[^may]:即：每年的公歷五月份

• 效果：
  Hello May^[1]

腳注的注意事項：

• 腳注 id 必須唯一。
• 無論腳注 id 如何起名，顯示時一律標為數(shù)字，并且按出現(xiàn)順序排列。

六、雙標記

1) 行內(nèi)代碼塊

• 語法：使用兩個 ` 將代碼包含起來。

• 示例代碼

在 OC 中輸出 Hello May : `MSLog(@"Hello May");`

• 效果
  在 OC 中輸出 Hello May : MSLog(@"Hello May");

2) 多行代碼塊

• 語法：只需要每行都縮進 4 個空格即可，或者使用```框起來。

• 示例代碼
  ```
  $(function(){
  alert("Hello May!");
  });
  /```

• 效果

$(function(){
  alert("Hello May!");
});

• 注意事項：
  1.在代碼區(qū)塊內(nèi)部，", <>,& 將會自動轉(zhuǎn)換為轉(zhuǎn)義字符
  2.在代碼區(qū)塊內(nèi)部，Markdown 標記將保持原樣，即：星號()就是星號()，不被解釋為特殊標記，這樣就可以不能繼續(xù)使用 Markdown 語法了**

七、表格

• 語法：
  1、第一行為表頭，第二行分隔表頭和主體部分，第三行開始每一行為一個表格行。
  2、列于列之間用管道符 | 隔開。表格每一行兩邊的管道符可省略。
  3、第二行還可以為不同的列指定對齊方向。標題默認為居中對齊，內(nèi)容默認為左對齊；在 - 左邊加上 : 就是左對齊；在 - 右邊加上 : 就是右對齊；在 - 兩邊都加上 : 就是居中對齊。

• 示例代碼

|姓名|性別|學(xué)號|成績|
|:---|:---|:---:|---:|
|喜羊羊|男|001|220|

• 效果

八、其他問題

1.Markdown 與 html 的關(guān)系

1).HTML 是一種發(fā)布的格式，Markdown 是一種書寫的格式。
2).Markdown 的格式語法只涵蓋純文本可以涵蓋的范圍。
3).在 Markdown 中可直接使用 HTML 標簽，但需要注意

• 對于 HTML 區(qū)塊元素――如 div、table、pre、p 等標簽，必須在前后加上空行與其它內(nèi)容區(qū)隔開，還要求它們的開始標簽與結(jié)尾標簽不能用制表符(tab)或空格來縮進
• HTML 的行內(nèi)標簽——如 span、cite、del 可以在 Markdown 的段落、列表或是標題里隨意使用。
• 在 HTML 的區(qū)塊標簽中的 Markdown 標簽是沒有效果

2.特殊字符的自動轉(zhuǎn)換

• 在 HTML 文件中，有兩個字符需要特殊處理： < 和 &，必須使用轉(zhuǎn)義字符：& lt ; 和 & amp ;
• Markdown 中，你可以自由的書寫 < 和 &，編輯器會智能的進行判斷：當這些符號用于 HTML 標簽中，他們將保留原型；當他們單獨使用時，將會轉(zhuǎn)換為字符實體。
• 在代碼塊中，它們將統(tǒng)統(tǒng)被轉(zhuǎn)換為字符實體，即：原樣顯示。

3.Markdown 中的轉(zhuǎn)義字符

Markdown 中，如需顯示有特定意義的符號，如：*,# 等，可使用 反斜杠 \ 進行轉(zhuǎn)義。可對如下字符進行轉(zhuǎn)義：

*
`
*
_
{}
()
#
+
-
.
!  

1. 即：每年的公歷五月份 ?