diff --git a/Han b/Han deleted file mode 160000 index 182e3f6..0000000 --- a/Han +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 182e3f69bc606da652ec4bc52edd6ab343954640 diff --git a/basics.md b/basics.md index 41397d8..d14c245 100644 --- a/basics.md +++ b/basics.md @@ -4,23 +4,25 @@ 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] +**提示:**這份文件本身也是用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,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 +段落、標題、區塊程式碼 +------------------ -Markdown 支援兩種標題的語法,[Setext] [1] 和 [atx] [2] 形式。Setext 形式是用底線的形式,利用 `=` (最高階標題)和 `-` (第二階標題),Atx 形式在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階。 +一個段落是由一個以上的連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和tab,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 -區塊引言則使用 email 形式的 '`>`' 角括號。 +Markdown支援兩種標題的語法,[Setext][1]和[atx][2]形式。Setext形式是用底線的形式,利用`=`(最高階標題)和`-`(第二階標題),Atx形式在行首插入1到6個`#` ,對應到標題1到6階。 + +區塊引言則使用email形式的'`>`'角括號。 Markdown: @@ -72,9 +74,9 @@ Markdown: ### 修辭和強調 ### -Markdown 使用星號和底線來標記需要強調的區段。 +Markdown使用星號和底線來標記需要強調的區段。 -Markdown: +Markdown: Some of these words *are emphasized*. Some of these words _are emphasized also_. @@ -82,7 +84,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.
@@ -118,7 +120,7 @@ Markdown:` 包起來,你也可以在一個項目內放上多個段落,只要在它前面縮排 4 個空白或 1 個 tab 。 +如果你在項目之間插入空行,那項目的內容會備用`
`包起來,你也可以在一個項目內放上多個段落,只要在它前面縮排4個空白或1個 tab 。 * A list item. @@ -150,7 +152,7 @@ Markdown: ### 連結 ### -Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式,兩種都是使用角括號來把文字轉成連結。 +Markdown支援兩種形式的連結語法:*行內*和*參考*兩種形式,兩種都是使用角括號來把文字轉成連結。 行內形式形式是直接在後面用括號直接接上連結: @@ -161,7 +163,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
This is an example link.
-你也可以選擇性的加上 title 屬性: +你也可以選擇性的加上title屬性: This is an [example link](http://example.com/ "With a Title"). @@ -186,7 +188,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]. @@ -203,7 +205,7 @@ title 屬性是選擇性的,連結名稱可以用字母、數字和空格, 圖片的語法和連結很像。 -行內形式(title 是選擇性的): +行內形式(title是選擇性的): ![alt text](/path/to/img.jpg "Title") @@ -219,7 +221,7 @@ title 屬性是選擇性的,連結名稱可以用字母、數字和空格, ### 程式碼 ### -在一般的段落文字中,你可以使用反引號 `` ` `` 來標記程式碼區段,區段內的 `&`、`<` 和 `>` 都會被自動的轉換成 HTML 實體,這項特性讓你可以很容易的在程式碼區段內插入 HTML 碼: +在一般的段落文字中,你可以使用反引號`` ` ``來標記程式碼區段,區段內的 `&`、`<` 和 `>` 都會被自動地轉換成HTML實體,這項特性讓你可以很容易的在程式碼區段內插入HTML碼: I strongly recommend against using any `