Browse Source

editing

pull/1/head
othree 14 years ago
parent
commit
ea62049957
  1. 36
      syntax.md

36
syntax.md

@ -55,7 +55,7 @@ Markdown 將容易閱讀和容易寫作這兩點作為主要目標。
為了這個目的,Markdown 的語法全部由標點符號來組成,標點符號的選擇是依 為了這個目的,Markdown 的語法全部由標點符號來組成,標點符號的選擇是依
據他們看起來樣子或是他們的意義慎重的考慮的,像是在文字兩旁加上星號,看 據他們看起來樣子或是他們的意義慎重的考慮的,像是在文字兩旁加上星號,看
起來就很像在 \*強調\* 。Markdow 的清單就很像是清單,區塊引研究很像是電 起來就很像在 \*強調\* 。Markdow 的清單就很像是清單,區塊引言就很像是電
子郵件的引言。 子郵件的引言。
<h3 id="html">行內 HTML</h3> <h3 id="html">行內 HTML</h3>
@ -63,8 +63,8 @@ Markdown 將容易閱讀和容易寫作這兩點作為主要目標。
Markdown 的語法有個主要的目的:用來作為一種網路內容的 *寫作* 用語言。 Markdown 的語法有個主要的目的:用來作為一種網路內容的 *寫作* 用語言。
Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多, Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法種類不多,
只和 HTML 的一部分有關係,重點 *不是* 要創造一種更容易插入 HTML 標籤 只和 HTML 的一部分有關係,重點 *不是* 要創造一種更容易寫作 HTML 文件
的語法,我認為 HTML 已經很容易插入了,Markdown 的重點在讓文件更容易 的語法,我認為 HTML 已經很容易了,Markdown 的重點在讓文件更容易
閱讀、編寫,HTML 是一種 *發佈* 的格式,Markdown 是一種 *編寫* 的格式, 閱讀、編寫,HTML 是一種 *發佈* 的格式,Markdown 是一種 *編寫* 的格式,
因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。 因此,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍。
@ -91,13 +91,13 @@ Markdown 不是要來取代 HTML,甚至也沒有要和它相似,它的語法
請注意,在 HTML 區塊標籤內,是不會對 Markdown 的語法進行處理的。例如, 請注意,在 HTML 區塊標籤內,是不會對 Markdown 的語法進行處理的。例如,
HTML 區塊內,無法使用 Markdown 形式的 `*強調*` HTML 區塊內,無法使用 Markdown 形式的 `*強調*`
HTML 的跨度標間如 `<span>`, `<cite>` 或者 `<del>` 則不受限制,可以在 HTML 的區段標間如 `<span>`, `<cite>` 或者 `<del>` 則不受限制,可以在
Markdown 的段落、清單或是檔頭裡任意使用。依照個人習慣,甚至可以不用 Markdown 的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用
Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML Markdown 格式,而採用 HTML 標籤來格式化。舉例說明:如果比較喜歡 HTML
`<a>``<img>` 標籤,可以直接使用這些標籤,而不用 Markdown 提 `<a>``<img>` 標籤,可以直接使用這些標籤,而不用 Markdown 提
供的連結或是影像標示語法。 供的連結或是影像標示語法。
HTML 跨度標籤和區塊標籤不同,在跨度標籤的範圍內, Markdown 的語法是有效的。 HTML 區段標籤和區塊標籤不同,在區段標籤的範圍內, Markdown 的語法是有效的。
<h3 id="autoescape">特殊字元自動轉換</h3> <h3 id="autoescape">特殊字元自動轉換</h3>
@ -106,7 +106,7 @@ HTML 跨度標籤和區塊標籤不同,在跨度標籤的範圍內, Markdown
使用實體的形式,像是 `&lt;``&amp;` 使用實體的形式,像是 `&lt;``&amp;`
`&` 符號其實很讓寫作網路文件的人很困擾,如果你要打 'AT&T' ,你必須要寫成 `&` 符號其實很讓寫作網路文件的人很困擾,如果你要打 'AT&T' ,你必須要寫成
'`AAT&amp;T`' ,你還必須要轉換網址內的 `&` 符號,如果你要連結到: '`AT&amp;T`' ,你還必須要轉換網址內的 `&` 符號,如果你要連結到:
http://images.google.com/images?num=30&q=larry+bird http://images.google.com/images?num=30&q=larry+bird
@ -114,8 +114,8 @@ HTML 跨度標籤和區塊標籤不同,在跨度標籤的範圍內, Markdown
http://images.google.com/images?num=30&amp;q=larry+bird http://images.google.com/images?num=30&amp;q=larry+bird
才能放到你的連結標籤的 `href` 裡,不用說,這很容易忘記,可能是最大 才能放到你的連結標籤的 `href` 裡,不用說也知道這很容易忘記,這也可能是數量最多
HTML 標準檢查的錯誤來源 HTML 標準檢查的錯誤。
Markdown 允許你直接使用這些符號,但是你要小心跳脫字元的使用,如果你是在 Markdown 允許你直接使用這些符號,但是你要小心跳脫字元的使用,如果你是在
HTML 實體中使用 `&` 符號的話,它不會被轉換,而在其它情形下,它則會被轉換 HTML 實體中使用 `&` 符號的話,它不會被轉換,而在其它情形下,它則會被轉換
@ -133,7 +133,7 @@ Markdown 就會將它轉為:
AT&amp;T AT&amp;T
類似的狀況也會發生在 `<` 符號上,因為 Markdown 支援 [inline HTML](#html) , 類似的狀況也會發生在 `<` 符號上,因為 Markdown 支援 [行內 HTML](#html) ,
如果你是使用 `<` 符號作為 HTML 標籤使用,那 Markdown 也不會對它做任何轉換, 如果你是使用 `<` 符號作為 HTML 標籤使用,那 Markdown 也不會對它做任何轉換,
但是如果你是寫: 但是如果你是寫:
@ -146,7 +146,7 @@ Markdown 將會把它轉換為:
不過要注意的是,code 範圍內,不論是行內還是區塊, `<``&` 兩個符號都 *一定* 不過要注意的是,code 範圍內,不論是行內還是區塊, `<``&` 兩個符號都 *一定*
會被轉換成 HTML 實體,這項特性讓你可以很容易的用 Markdown 寫 HTML code 會被轉換成 HTML 實體,這項特性讓你可以很容易的用 Markdown 寫 HTML code
(和 HTML 相對而言, HTML 語法中,你要把所有的 `<``&` 都轉換為 HTML 實體, (和 HTML 相對而言, HTML 語法中,你要把所有的 `<``&` 都轉換為 HTML 實體,
你才能 HTML 文件裡面寫出 HTML code) 你才能 HTML 文件裡面寫出 HTML code)
* * * * * *
@ -155,11 +155,11 @@ Markdown 將會把它轉換為:
<h3 id="p">段落和換行</h3> <h3 id="p">段落和換行</h3>
一個段落是由一個以上連接的行句組成,而一個以上的空行則會切分出不同的段落 一個段落是由一個以上連接的行句組成,而一個以上的空行則會切分出不同的段落
(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab, (空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,
那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。
「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行, 「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行,
這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的
"Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。 "Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。
@ -167,7 +167,7 @@ Markdown 將會把它轉換為:
是的,這確實讓你要花比較多功夫插入 `<br />` ,但是「每個換行都轉換為 `<br />` 是的,這確實讓你要花比較多功夫插入 `<br />` ,但是「每個換行都轉換為 `<br />`
的方法在 Markdown 中並不適合, Markdown 的 email 式的 [區塊引言][bq] 和多段落的 的方法在 Markdown 中並不適合, Markdown 的 email 式的 [區塊引言][bq] 和多段落的
[清單][l] 在使用換行來排版的時候,不但更好用,還更好 [清單][l] 在使用換行來排版的時候,不但更好用,還更好閱讀
[bq]: #blockquote [bq]: #blockquote
[l]: #list [l]: #list
@ -187,7 +187,7 @@ Setext 形式是用底線的形式,利用 `=` (最高階標題)和 `-` (
任何數量的 `=``-` 都可以有效果。 任何數量的 `=``-` 都可以有效果。
Atx 形式在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階,例如: Atx 形式則是在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階,例如:
# This is an H1 # This is an H1
@ -267,7 +267,7 @@ Markdown 支援有序清單和無序清單。
+ Green + Green
+ Blue + Blue
也等同於
- Red - Red
- Green - Green
@ -642,7 +642,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,
un*frigging*believable un*frigging*believable
如果你的 `*``_` 兩邊都有空白的話,它們就只會被當成普通的符號。 如果你的 `*``_` 兩邊都有空白的話,它們就只會被當成普通的符號。
如果要在文字前後直接插入普通的星號或底線,你可以用反斜線: 如果要在文字前後直接插入普通的星號或底線,你可以用反斜線:
@ -760,7 +760,7 @@ Markdown 會轉成:
在瀏覽器裡面,這段字串會變成一個可以點擊的 "address@example.com" 連結。 在瀏覽器裡面,這段字串會變成一個可以點擊的 "address@example.com" 連結。
(這種作法雖然可以混淆不少的機器人,但並不是全部,不過這樣也比什麼都不做還好 (這種作法雖然可以混淆不少的機器人,但並無法全部檔下來,不過這樣也比什麼都不做還好
不管如何,公開你的信箱終究是會引來廣告信件的。) 不管如何,公開你的信箱終究是會引來廣告信件的。)
<h3 id="backslash">跳脫字元</h3> <h3 id="backslash">跳脫字元</h3>

Loading…
Cancel
Save