Markdown簡明教程

小組須要使用Markdown來記錄，因此整理了一個簡明教程給你們瀏覽~

1. 標題

　　語法：# + 空格 + 標題文字

　　標題分爲1-6級，增長一個"#"號，標題增長一級，示例以下：

 

2.強調

l  粗體

　　語法：** + 文本 + **

l  斜體

　　語法：* + 文本 + *

l  分割線

　　語法：***（單獨一行輸入三個星號）或者---（單獨一行輸入三個減號）

效果以下：

（注意：星號與文本之間無空格）

 

3. 引用

　　語法：> + 空格 +引用文本

效果以下：

 

4. 列表

l  有序列表

　　語法：數字+英文句號+空格+文本

　　（eg：1. 我是文本）

l  無序列表

　　語法：符號+空格+文本

　　（此處符號能夠是星號、加號和減號）

效果以下：

 

5. 連接

l  行內

　　語法：[顯示的連接名](連接url地址)

　　eg: 這是一個[連接](http://baidu.com)

l  參考

　　語法：[顯示的連接名](連接id)

　　爲連接定一個名稱，以後在文件的其餘地方定義該連接的內容

　　eg:這是連接1 [Google][1] ，這是連接2[Yahoo][2] .

　　[1]: http://google.com/ "Google"

　　[2]: http://search.yahoo.com/ "Yahoo Search"

l  html標籤

　　因爲markdown支持html語法，因此也能夠用html的<a>標籤

　　語法：<a  href=「連接url地址」>

　　eg：<a  href="http://baidu.com">連接名</a>

效果以下：

 

 

6. 圖片

l  行內

　　語法：

　　eg:  

l  參考

　　語法：，在文件的其餘地方定義該圖片id的路徑

　　eg:  ![代替文本][id]

　　 [id]: /path/to/img.jpg "Title"

l  html標籤

　　因爲markdown支持html語法，因此也能夠用html的<img>標籤，我的認爲相對方 便，能夠直接調整大小

　　語法：<img  src=「圖片地址路徑」 title="標題"  width="200px" height="200px「>

　　eg：<img  src=" /path/to/img.jpg"  width="100px">

效果以下：

 

 

7. 代碼

l  代碼區段

　　語法：反引號 ` 標記代碼區段

　　區段內的 &、< 和 > 都會被自動的轉換成 HTML 實體

l  代碼區塊

　　語法：每行都縮進 4 個空格或是一個 tab

　　若是要創建一個已經格式化好的代碼區塊，只要每行都縮進 4 個空格或是一個 tab 就能夠了，而 &、< 和 > 也同樣會自動轉成 HTML 實體。

效果以下：

 

8.反斜槓

　　Markdown 能夠利用反斜槓來插入一些在語法中有其它意義的符號

　　語法：\ + 在語法中有意義的符號

 

注：

1.markdown語法兼容 HTML

Markdown 語法的目標是：成爲一種適用於網絡的書寫語言，它的語法種類只對應 HTML 標記的一小部分（只涵蓋純文本）。HTML 是一種發佈的格式，Markdown 是一種書寫的格式。

不在 Markdown 涵蓋範圍以內的標籤，均可以直接在文檔裏面用 HTML 撰寫。不須要額外標註這是 HTML 或是 Markdown；只要直接加標籤就能夠了。

要制約的只有一些 HTML 區塊元素――好比 <div>、<table>、<pre>、<p> 等標籤，必須在先後加上空行與其它內容區隔開，還要求它們的開始標籤與結尾標籤不能用製表符或空格來縮進。

2.本文檔提供經常使用語法使用，推薦一個詳細教程：http://www.appinn.com/markdown/index.html