diff --git a/Han b/Han new file mode 160000 index 0000000..182e3f6 --- /dev/null +++ b/Han @@ -0,0 +1 @@ +Subproject commit 182e3f69bc606da652ec4bc52edd6ab343954640 diff --git a/basics.md b/basics.md index d14c245..41397d8 100644 --- a/basics.md +++ b/basics.md @@ -4,25 +4,23 @@ 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。 -**提示:**這份文件本身也是用Markdown寫的,你也可以看看[它的原始碼][src] +**Note:** 這份文件本身也是用 Markdown 寫的,你也可以看看 [它的原始碼][src] [s]: http://markdown.tw "Markdown Syntax" [d]: http://daringfireball.net/projects/markdown/dingus "Markdown Dingus" [src]: https://github.com/othree/markdown-syntax-zhtw/blob/master/basics.md +## 段落、標題、區塊程式碼 ## -段落、標題、區塊程式碼 ------------------- +一個段落是由一個以上的連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 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形式的'`>`'角括號。 +區塊引言則使用 email 形式的 '`>`' 角括號。 Markdown: @@ -74,9 +72,9 @@ Markdown: ### 修辭和強調 ### -Markdown使用星號和底線來標記需要強調的區段。 +Markdown 使用星號和底線來標記需要強調的區段。 -Markdown: +Markdown: Some of these words *are emphasized*. Some of these words _are emphasized also_. @@ -84,7 +82,7 @@ Markdown: Use two asterisks for **strong emphasis**. Or, if you prefer, __use two underscores instead__. -輸出: +輸出:
Some of these words are emphasized. Some of these words are emphasized also.
@@ -120,7 +118,7 @@ Markdown:`包起來,你也可以在一個項目內放上多個段落,只要在它前面縮排4個空白或1個 tab 。 +如果你在項目之間插入空行,那項目的內容會備用 `
` 包起來,你也可以在一個項目內放上多個段落,只要在它前面縮排 4 個空白或 1 個 tab 。 * A list item. @@ -152,7 +150,7 @@ Markdown: ### 連結 ### -Markdown支援兩種形式的連結語法:*行內*和*參考*兩種形式,兩種都是使用角括號來把文字轉成連結。 +Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式,兩種都是使用角括號來把文字轉成連結。 行內形式形式是直接在後面用括號直接接上連結: @@ -163,7 +161,7 @@ Markdown支援兩種形式的連結語法:*行內*和*參考*兩種形式,
This is an example link.
-你也可以選擇性的加上title屬性: +你也可以選擇性的加上 title 屬性: This is an [example link](http://example.com/ "With a Title"). @@ -188,7 +186,7 @@ Markdown支援兩種形式的連結語法:*行內*和*參考*兩種形式, title="Yahoo Search">Yahoo or MSN. -title屬性是選擇性的,連結名稱可以用字母、數字和空格,但是不分大小寫: +title 屬性是選擇性的,連結名稱可以用字母、數字和空格,但是不分大小寫: I start my morning with a cup of coffee and [The New York Times][NY Times]. @@ -205,7 +203,7 @@ title屬性是選擇性的,連結名稱可以用字母、數字和空格,但 圖片的語法和連結很像。 -行內形式(title是選擇性的): +行內形式(title 是選擇性的): ![alt text](/path/to/img.jpg "Title") @@ -221,7 +219,7 @@ title屬性是選擇性的,連結名稱可以用字母、數字和空格,但 ### 程式碼 ### -在一般的段落文字中,你可以使用反引號`` ` ``來標記程式碼區段,區段內的 `&`、`<` 和 `>` 都會被自動地轉換成HTML實體,這項特性讓你可以很容易的在程式碼區段內插入HTML碼: +在一般的段落文字中,你可以使用反引號 `` ` `` 來標記程式碼區段,區段內的 `&`、`<` 和 `>` 都會被自動的轉換成 HTML 實體,這項特性讓你可以很容易的在程式碼區段內插入 HTML 碼: I strongly recommend against using any `