|
|
@ -4,12 +4,9 @@ Markdown: Basics |
|
|
|
Getting the Gist of Markdown's Formatting Syntax |
|
|
|
Getting the Gist of Markdown's Formatting Syntax |
|
|
|
------------------------------------------------ |
|
|
|
------------------------------------------------ |
|
|
|
|
|
|
|
|
|
|
|
這頁提供了 Markdown 簡單的概觀給想使用的人, [語法說明][s] 頁提供了 |
|
|
|
這頁提供了 Markdown 簡單的概觀給想使用的人, [語法說明][s] 頁提供了完整詳細的文件,說明每項功能,但是 Markdown 其實很簡單就可以上手,這頁文件提供了一些範例,並且每個範例都有提供輸出的 HTML 結果。 |
|
|
|
完整詳細的文件,說明每項功能,但是 Markdown 其實很簡單就可以上手, |
|
|
|
|
|
|
|
這頁文件提供了一些範例,並且每個範例都有提供輸出的 HTML 結果。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
其實直接試試看也是一個很不錯的方法, [Dingus][d] 是一個網頁應用程式, |
|
|
|
其實直接試試看也是一個很不錯的方法, [Dingus][d] 是一個網頁應用程式,讓你可以把你的 Markdown 文件轉成 XHTML。 |
|
|
|
讓你可以把你的 Markdown 文件轉成 XHTML。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**Note:** 這份文件本身也是用 Markdown 寫的,你也可以看看 [它的原始碼][src] |
|
|
|
**Note:** 這份文件本身也是用 Markdown 寫的,你也可以看看 [它的原始碼][src] |
|
|
|
|
|
|
|
|
|
|
@ -19,13 +16,9 @@ Getting the Gist of Markdown's Formatting Syntax |
|
|
|
|
|
|
|
|
|
|
|
## 段落、標題、區塊程式碼 ## |
|
|
|
## 段落、標題、區塊程式碼 ## |
|
|
|
|
|
|
|
|
|
|
|
一個段落是由一個以上的連接的行句組成,而一個以上的空行則會切分出不同的段落 |
|
|
|
一個段落是由一個以上的連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 |
|
|
|
(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab, |
|
|
|
|
|
|
|
那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Markdown 支援兩種標題的語法,[Setext] [1] 和 [atx] [2] 形式。 |
|
|
|
Markdown 支援兩種標題的語法,[Setext] [1] 和 [atx] [2] 形式。Setext 形式是用底線的形式,利用 `=` (最高階標題)和 `-` (第二階標題),Atx 形式在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階。 |
|
|
|
Setext 形式是用底線的形式,利用 `=` (最高階標題)和 `-` (第二階標題), |
|
|
|
|
|
|
|
Atx 形式在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
區塊引言則使用 email 形式的 '`>`' 角括號。 |
|
|
|
區塊引言則使用 email 形式的 '`>`' 角括號。 |
|
|
|
|
|
|
|
|
|
|
@ -99,8 +92,7 @@ Markdown: |
|
|
|
|
|
|
|
|
|
|
|
## 清單 ## |
|
|
|
## 清單 ## |
|
|
|
|
|
|
|
|
|
|
|
無序清單使用星號、加號和減號來做為清單的項目標記,這些符號是都可以使用的, |
|
|
|
無序清單使用星號、加號和減號來做為清單的項目標記,這些符號是都可以使用的,使用星號: |
|
|
|
使用星號: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* Candy. |
|
|
|
* Candy. |
|
|
|
* Gum. |
|
|
|
* Gum. |
|
|
@ -140,8 +132,7 @@ Markdown: |
|
|
|
<li>Blue</li> |
|
|
|
<li>Blue</li> |
|
|
|
</ol> |
|
|
|
</ol> |
|
|
|
|
|
|
|
|
|
|
|
如果你在項目之間插入空行,那項目的內容會備用 `<p>` 包起來,你也可以在一個項目 |
|
|
|
如果你在項目之間插入空行,那項目的內容會備用 `<p>` 包起來,你也可以在一個項目內放上多個段落,只要在它前面縮排 4 個空白或 1 個 tab 。 |
|
|
|
內放上多個段落,只要在它前面縮排 4 個空白或 1 個 tab 。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
* A list item. |
|
|
|
* A list item. |
|
|
|
|
|
|
|
|
|
|
@ -159,8 +150,7 @@ Markdown: |
|
|
|
|
|
|
|
|
|
|
|
### 連結 ### |
|
|
|
### 連結 ### |
|
|
|
|
|
|
|
|
|
|
|
Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式,兩種都是使用角括號 |
|
|
|
Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式,兩種都是使用角括號來把文字轉成連結。 |
|
|
|
來把文字轉成連結。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
行內形式形式是直接在後面用括號直接接上連結: |
|
|
|
行內形式形式是直接在後面用括號直接接上連結: |
|
|
|
|
|
|
|
|
|
|
@ -229,9 +219,7 @@ title 屬性是選擇性的,連結名稱可以用字母、數字和空格, |
|
|
|
|
|
|
|
|
|
|
|
### 程式碼 ### |
|
|
|
### 程式碼 ### |
|
|
|
|
|
|
|
|
|
|
|
在一般的段落文字中,你可以使用反引號 `` ` `` 來標記程式碼區段,區段內的 `&` |
|
|
|
在一般的段落文字中,你可以使用反引號 `` ` `` 來標記程式碼區段,區段內的 `&`、`<` 和 `>` 都會被自動的轉換成 HTML 實體,這項特性讓你可以很容易的在程式碼區段內插入 HTML 碼: |
|
|
|
、`<` 和 `>` 都會被自動的轉換成 HTML 實體,這項特性讓你可以很容易的在程式碼 |
|
|
|
|
|
|
|
區段內插入 HTML 碼: |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
I strongly recommend against using any `<blink>` tags. |
|
|
|
I strongly recommend against using any `<blink>` tags. |
|
|
|
|
|
|
|
|
|
|
@ -247,8 +235,7 @@ title 屬性是選擇性的,連結名稱可以用字母、數字和空格, |
|
|
|
<code>&mdash;</code> instead of decimal-encoded |
|
|
|
<code>&mdash;</code> instead of decimal-encoded |
|
|
|
entites like <code>&#8212;</code>.</p> |
|
|
|
entites like <code>&#8212;</code>.</p> |
|
|
|
|
|
|
|
|
|
|
|
如果要建立一個已經格式化好的程式碼區塊,只要每行都縮排 4 個空格或是一個 tab |
|
|
|
如果要建立一個已經格式化好的程式碼區塊,只要每行都縮排 4 個空格或是一個 tab 就可以了,而 `&`、`<` 和 `>` 也一樣會自動轉成 HTML 實體。 |
|
|
|
就可以了,而 `&`、`<` 和 `>` 也一樣會自動轉成 HTML 實體。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Markdown: |
|
|
|
Markdown: |
|
|
|
|
|
|
|
|
|
|
|