Browse Source

minor modified

pull/1/head
Tan I-kun 14 years ago
parent
commit
ff05b4b88d
  1. 34
      syntax.md

34
syntax.md

@ -28,7 +28,7 @@ Markdown: Syntax @@ -28,7 +28,7 @@ Markdown: Syntax
* [自動連結](#autolink)
* [感謝](#acknowledgement)
**Note:** 這份文件是用 Markdown 寫的,你可以 [看看它的原始檔][src] 。
**注意:**這份文件是用 Markdown 寫的,你可以[看看它的原始檔][src] 。
[src]: https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md
@ -55,7 +55,7 @@ Markdown 的目標是實現「易讀易寫」。 @@ -55,7 +55,7 @@ Markdown 的目標是實現「易讀易寫」。
Markdown 的語法有個主要的目的:用來作為一種網路內容的*寫作*用語言。
Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多,只和 HTML 的一部分有關係,重點 *不是* 要創造一種更容易寫作 HTML 文件的語法,我認為 HTML 已經很容易寫了,Markdown 的重點在於,它能讓文件更容易閱讀、編寫。HTML 是一種 *發佈* 的格式,Markdown 是一種 *編寫* 的格式,因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。
Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多,只和 HTML 的一部分有關係,重點*不是*要創造一種更容易寫作 HTML 文件的語法,我認為 HTML 已經很容易寫了,Markdown 的重點在於,它能讓文件更容易閱讀、編寫。HTML 是一種*發佈*的格式,Markdown 是一種*編寫*的格式,因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。
不在 Markdown 涵蓋範圍之外的標籤,都可以直接在文件裡面用 HTML 撰寫。不需要額外標註這是 HTML 或是 Markdown;只要直接加標籤就可以了。
@ -73,7 +73,7 @@ Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法 @@ -73,7 +73,7 @@ Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法
This is another regular paragraph.
請注意,Markdown 語法在 HTML 區塊標籤中將不會被進行處理。例如,你無法在 HTML 區塊內使用 Markdown 形式的 `*強調*`
請注意,Markdown 語法在 HTML 區塊標籤中將不會被進行處理。例如,你無法在 HTML 區塊內使用 Markdown 形式的`*強調*`。
HTML 的區段標籤如 `<span>`、`<cite>`、`<del>` 則不受限制,可以在 Markdown 的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML 的 `<a>``<img>` 標籤,可以直接使用這些標籤,而不用 Markdown 提供的連結或是影像標示語法。
@ -126,7 +126,7 @@ Markdown 將會把它轉換為: @@ -126,7 +126,7 @@ Markdown 將會把它轉換為:
「一個以上相連接的行句組成」這句話其實暗示了 Markdown 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的「Convert Line Breaks」選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。
如果你 *真的* 想要插入 `<br />` 標籤的話,在行尾加上兩個以上的空白,然後按 enter。
如果你*真的*想要插入 `<br />` 標籤的話,在行尾加上兩個以上的空白,然後按 enter。
是的,這確實需要花比較多功夫來插入 `<br />` ,但是「每個換行都轉換為 `<br />`」的方法在 Markdown 中並不適合, Markdown 中 email 式的 [區塊引言][bq] 和多段落的 [清單][l] 在使用換行來排版的時候,不但更好用,還更好閱讀。
@ -203,7 +203,7 @@ Markdown 也允許你只在整個段落的第一行最前面加上 `>` : @@ -203,7 +203,7 @@ Markdown 也允許你只在整個段落的第一行最前面加上 `>` :
>
> return shell_exec("echo $input | $markdown_script");
任何標準的文字編輯器都能簡單地建立 email 樣式的引言,例如 BBEdit ,你可以選取文字後然後從選單中選擇 *增加引言階層*
任何標準的文字編輯器都能簡單地建立 email 樣式的引言,例如 BBEdit ,你可以選取文字後然後從選單中選擇*增加引言階層*。
<h3 id="list">清單</h3>
@ -330,7 +330,7 @@ Markdown 支援有序清單和無序清單。 @@ -330,7 +330,7 @@ Markdown 支援有序清單和無序清單。
> This is a blockquote
> inside a list item.
如果要放程式碼區塊的話,該區塊就需要縮排 *兩次* ,也就是 8 個空白或是兩個 tab:
如果要放程式碼區塊的話,該區塊就需要縮排*兩次* ,也就是 8 個空白或是兩個 tab:
* A list item with a code block:
@ -341,7 +341,7 @@ Markdown 支援有序清單和無序清單。 @@ -341,7 +341,7 @@ Markdown 支援有序清單和無序清單。
1986. What a great season.
換句話說,也就是在行首出現 *數字-句點-空白* ,要避免這樣的狀況,你可以在句點前面加上反斜線。
換句話說,也就是在行首出現*數字-句點-空白*,要避免這樣的狀況,你可以在句點前面加上反斜線。
1986\. What a great season.
@ -417,7 +417,7 @@ Markdown 會轉換成: @@ -417,7 +417,7 @@ Markdown 會轉換成:
<h3 id="link">連結</h3>
Markdown 支援兩種形式的連結語法: *行內* *參考* 兩種形式。
Markdown 支援兩種形式的連結語法: *行內*和*參考*兩種形式。
不管是哪一種,連結的文字都是用 [方括號] 來標記。
@ -465,7 +465,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式 @@ -465,7 +465,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
**Note:** 有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的連結 title。
**請注意:** 有一個已知的問題是 Markdown.pl 1.0.1 會忽略單引號包起來的連結 title。
連結網址也可以用角括號包起來:
@ -478,12 +478,12 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式 @@ -478,12 +478,12 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
網址定義只有在產生連結的時候用到,並不會直接出現在文件之中。
連結辨識標籤可以有字母、數字、空白和標點符號,但是並 *不* 區分大小寫,因此下面兩個連結是一樣的:
連結辨識標籤可以有字母、數字、空白和標點符號,但是並*不*區分大小寫,因此下面兩個連結是一樣的:
[link text][a]
[link text][A]
*預設的連結標籤* 功能讓你可以省略指定連結標籤,這種情形下,連結標籤和連結文字會視為相同,要用預設連結標籤只要在連結文字後面加上一個空的角括號,如果你要讓 "Google" 連結到 google.com,你可以簡化成:
*預設的連結標籤*功能讓你可以省略指定連結標籤,這種情形下,連結標籤和連結文字會視為相同,要用預設連結標籤只要在連結文字後面加上一個空的角括號,如果你要讓 "Google" 連結到 google.com,你可以簡化成:
[Google][]
@ -538,7 +538,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式 @@ -538,7 +538,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
<h3 id="em">強調</h3>
Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,被 `*` 或`_` 包圍的字詞會被轉成用 `<em>` 標籤包圍,用兩個 `*``_` 包起來的話,則會被轉成 `<strong>` ,例如:
Markdown 使用星號(`*`)和底線(`_`)作為標記強調字詞的符號,被 `*` `_` 包圍的字詞會被轉成用 `<em>` 標籤包圍,用兩個 `*``_` 包起來的話,則會被轉成 `<strong>`,例如:
*single asterisks*
@ -572,7 +572,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號, @@ -572,7 +572,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,
<h3 id="code">程式碼</h3>
如果要標記一小段行內程式碼,你可以用反引號把它包起來 (`` ` ``),例如:
如果要標記一小段行內程式碼,你可以用反引號把它包起來(`` ` ``),例如:
Use the `printf()` function.
@ -600,7 +600,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號, @@ -600,7 +600,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
在程式碼區段內, `&` 和角括號都會被轉成 HTML 實體,這樣會比較容易插入 HTML 原始碼,Markdown 會把下面這段:
在程式碼區段內,`&` 和角括號都會被轉成 HTML 實體,這樣會比較容易插入 HTML 原始碼,Markdown 會把下面這段:
Please don't use any `<blink>` tags.
@ -623,7 +623,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號, @@ -623,7 +623,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,
很明顯地,要在純文字應用中設計一個 「自然」的語法來插入圖片是有一定難度的。
Markdown 使用一種和連結很相似的語法來標記圖片,同樣也允許兩種樣式: *行內* *參考*
Markdown 使用一種和連結很相似的語法來標記圖片,同樣也允許兩種樣式: *行內*和*參考*。
行內圖片的語法看起來像是:
@ -642,7 +642,7 @@ Markdown 使用一種和連結很相似的語法來標記圖片,同樣也允 @@ -642,7 +642,7 @@ Markdown 使用一種和連結很相似的語法來標記圖片,同樣也允
![Alt text][id]
"id" 是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:
「id」是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:
[id]: url/to/image "Optional title attribute"
@ -700,7 +700,7 @@ Markdown 支援在下面這些符號前面加上反斜線來幫助插入普通 @@ -700,7 +700,7 @@ Markdown 支援在下面這些符號前面加上反斜線來幫助插入普通
<h2 id="acknowledgement">感謝</h2>
感謝 [leafy7382][] 協助翻譯,[ethantw][] 的 [漢字標準格式・CSS Reset][]。
感謝 [leafy7382][] 協助翻譯,[ethantw][] 的[漢字標準格式・CSS Reset][]。
[leafy7382]:https://twitter.com/#!/leafy7382
[ethantw]:https://twitter.com/#!/ethantw

Loading…
Cancel
Save