diff --git a/basics.md b/basics.md index 84b8c6f..41397d8 100644 --- a/basics.md +++ b/basics.md @@ -4,12 +4,9 @@ Markdown: Basics Getting the Gist of Markdown's Formatting Syntax ------------------------------------------------ -這頁提供了 Markdown 簡單的概觀給想使用的人, [語法說明][s] 頁提供了 -完整詳細的文件,說明每項功能,但是 Markdown 其實很簡單就可以上手, -這頁文件提供了一些範例,並且每個範例都有提供輸出的 HTML 結果。 +這頁提供了 Markdown 簡單的概觀給想使用的人, [語法說明][s] 頁提供了完整詳細的文件,說明每項功能,但是 Markdown 其實很簡單就可以上手,這頁文件提供了一些範例,並且每個範例都有提供輸出的 HTML 結果。 -其實直接試試看也是一個很不錯的方法, [Dingus][d] 是一個網頁應用程式, -讓你可以把你的 Markdown 文件轉成 XHTML。 +其實直接試試看也是一個很不錯的方法, [Dingus][d] 是一個網頁應用程式,讓你可以把你的 Markdown 文件轉成 XHTML。 **Note:** 這份文件本身也是用 Markdown 寫的,你也可以看看 [它的原始碼][src] @@ -19,13 +16,9 @@ Getting the Gist of Markdown's Formatting Syntax ## 段落、標題、區塊程式碼 ## -一個段落是由一個以上的連接的行句組成,而一個以上的空行則會切分出不同的段落 -(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab, -那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 +一個段落是由一個以上的連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 -Markdown 支援兩種標題的語法,[Setext] [1] 和 [atx] [2] 形式。 -Setext 形式是用底線的形式,利用 `=` (最高階標題)和 `-` (第二階標題), -Atx 形式在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階。 +Markdown 支援兩種標題的語法,[Setext] [1] 和 [atx] [2] 形式。Setext 形式是用底線的形式,利用 `=` (最高階標題)和 `-` (第二階標題),Atx 形式在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階。 區塊引言則使用 email 形式的 '`>`' 角括號。 @@ -99,8 +92,7 @@ Markdown: ## 清單 ## -無序清單使用星號、加號和減號來做為清單的項目標記,這些符號是都可以使用的, -使用星號: +無序清單使用星號、加號和減號來做為清單的項目標記,這些符號是都可以使用的,使用星號: * Candy. * Gum. @@ -140,8 +132,7 @@ Markdown:
` 包起來,你也可以在一個項目 -內放上多個段落,只要在它前面縮排 4 個空白或 1 個 tab 。 +如果你在項目之間插入空行,那項目的內容會備用 `
` 包起來,你也可以在一個項目內放上多個段落,只要在它前面縮排 4 個空白或 1 個 tab 。 * 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 `
-如果要建立一個已經格式化好的程式碼區塊,只要每行都縮排 4 個空格或是一個 tab -就可以了,而 `&`、`<` 和 `>` 也一樣會自動轉成 HTML 實體。 +如果要建立一個已經格式化好的程式碼區塊,只要每行都縮排 4 個空格或是一個 tab 就可以了,而 `&`、`<` 和 `>` 也一樣會自動轉成 HTML 實體。 Markdown: