Browse Source

some characters and punctuations corrected.

pull/1/head
Tan I-kun 14 years ago
parent
commit
116b34d6d4
  1. 26
      syntax.md

26
syntax.md

@ -49,7 +49,7 @@ Markdown 的目標是實現「易讀易寫」。
[5]: http://www.triptico.com/software/grutatxt.html [5]: http://www.triptico.com/software/grutatxt.html
[6]: http://ettext.taint.org/doc/ [6]: http://ettext.taint.org/doc/
因此 Markdown 的語法由標點符號所組成,並且經過謹慎考慮,為的是看起來就像是它們所要表達的意思。像是在文字兩旁加上星號,看起來就像 \*強調\* 。Markdown 的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的是引用一段文字。 因此 Markdown 的語法全由標點符號所組成,並且經過謹慎考慮,為的是讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號,看起來就像\*強調\*。Markdown 的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的是引用一段文字。
<h3 id="html">行內 HTML</h3> <h3 id="html">行內 HTML</h3>
@ -124,7 +124,7 @@ Markdown 將會把它轉換為:
一個段落是由一個以上連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。 一個段落是由一個以上連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,就被視為空行,例如有一行只有空白和 tab,那該行也會被視為空行),一般的段落不需要用空白或斷行縮排。
「一個以上連接的行句組成」這句其實暗示了 Markdow 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 "Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。 「一個以上連接的行句組成」這句其實暗示了 Markdown 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的 "Convert Line Breaks" 選項),其它的格式會把每個斷行都轉成 `<br />` 標籤。
如果你 *真的* 是想要插入 `<br />` 標籤的話,在行尾加上兩個以上的空白,然後按 enter。 如果你 *真的* 是想要插入 `<br />` 標籤的話,在行尾加上兩個以上的空白,然後按 enter。
@ -155,7 +155,7 @@ Atx 形式則是在行首插入 1 到 6 個 `#` ,對應到標題 1 到 6 階
###### This is an H6 ###### This is an H6
你可以選擇性的 "關閉" atx 樣式的標題,這純粹只是美觀用的,你如果覺得這樣看起來比較好,就可以加上 `#` 在行尾,而行尾的 `#` 數量也不用和開頭一樣(行首的數量決定標題的階數): 你可以選擇性地「關閉」atx 樣式的標題,這純粹只是美觀用的,你如果覺得這樣看起來比較好,就可以加上 `#` 在行尾,而行尾的 `#` 數量也不用和開頭一樣(行首的數量決定標題的階數):
# This is an H1 # # This is an H1 #
@ -253,7 +253,7 @@ Markdown 支援有序清單和無序清單。
1. McHale 1. McHale
8. Parish 8. Parish
你都會得到完全一樣的 HTML 輸出,重點在於,你可以讓你的 Markdown 文件的清單數字和輸出的結果一樣,或是你懶一點,你可以完全不用在意數字的正確性。 你都會得到完全一樣的 HTML 輸出。重點在於,你可以讓 Markdown 文件的清單數字和輸出的結果相同,或是你懶一點,你可以完全不用在意數字的正確性。
如果你使用懶惰的寫法,建議第一個項目最好還是從 1. 開始,因為 Markdown 未來可能會支援有序清單的 start 屬性。 如果你使用懶惰的寫法,建議第一個項目最好還是從 1. 開始,因為 Markdown 未來可能會支援有序清單的 start 屬性。
@ -301,7 +301,7 @@ Markdown 支援有序清單和無序清單。
<li><p>Magic</p></li> <li><p>Magic</p></li>
</ul> </ul>
清單項目可以包含多個段落,每個項目下的端落都必須要縮排 4 個空白或是一個 tab : 清單項目可以包含多個段落,每個項目下的段落都必須縮排 4 個空白或是一個 tab :
1. This is a list item with two paragraphs. Lorem ipsum dolor 1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit sit amet, consectetuer adipiscing elit. Aliquam hendrerit
@ -313,7 +313,7 @@ Markdown 支援有序清單和無序清單。
2. Suspendisse id sem consectetuer libero luctus adipiscing. 2. Suspendisse id sem consectetuer libero luctus adipiscing.
如果你每行都有縮排,看起來會看好很多,當然,再次,如果你很懶惰,Markdown 也允許: 如果你每行都有縮排,看起來會看好很多,當然,再次,如果你很懶惰,Markdown 也允許:
* This is a list item with two paragraphs. * This is a list item with two paragraphs.
@ -379,9 +379,9 @@ Markdown 會轉換成:
end tell end tell
</code></pre> </code></pre>
一個程式碼區塊會一直持續到碰到沒有縮排的行(或是文件結尾)。 一個程式碼區塊會一直持續到碰到沒有縮排的那一行(或是文件結尾)。
在程式碼區塊裡面, `&``<``>` 會自動轉成 HTML 實體,這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,然後縮排就可以了,剩下的 Markdown 都會幫你處理,例如: 在程式碼區塊裡面, `&``<``>` 會自動轉成 HTML 實體,這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,然後縮排就可以了,剩下的 Markdown 都會幫你處理,例如:
<div class="footer"> <div class="footer">
&copy; 2004 Foo Corporation &copy; 2004 Foo Corporation
@ -479,7 +479,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
網址定義只有在產生連結的時候用到,並不會直接出現在文件之中。 網址定義只有在產生連結的時候用到,並不會直接出現在文件之中。
連結辨識標籤可以有字母、數字、空白和標點符號,但是並 *不* 分大小寫,因此下面兩個連結是一樣的: 連結辨識標籤可以有字母、數字、空白和標點符號,但是並 *不* 分大小寫,因此下面兩個連結是一樣的:
[link text][a] [link text][a]
[link text][A] [link text][A]
@ -527,7 +527,7 @@ Markdown 支援兩種形式的連結語法: *行內* 和 *參考* 兩種形式
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a> <a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p> or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
下面是用行內形式寫的同樣一段內容的 markdown 文件,提供作為比較之用: 下面是用行內形式寫的同樣一段內容的 Markdown 文件,提供作為比較之用:
I get 10 times more traffic from [Google](http://google.com/ "Google") I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
@ -622,7 +622,7 @@ Markdown 使用星號 (`*`) 和底線 (`_`) 作為標記強調字詞的符號,
<h3 id="img">圖片</h3> <h3 id="img">圖片</h3>
很明顯的,要設計一個 "自然" 的語法來在文字中插入圖片是很有難度的。 很明顯地,要設計一個 「自然」的語法用在文字中插入圖片是很有難度的。
Markdown 使用一種和連結很像的語法來標記圖片,同樣也允許兩種樣式: *行內**參考* Markdown 使用一種和連結很像的語法來標記圖片,同樣也允許兩種樣式: *行內**參考*
@ -663,7 +663,7 @@ Markdown 會轉為:
<a href="http://example.com/">http://example.com/</a> <a href="http://example.com/">http://example.com/</a>
自動的郵件連結也很類似,只是 Markdown 會先做一個編碼轉換的過程,把文字字元轉成16進位碼的 HTML 實體,這樣的格式可以混淆一些不好的信箱位置收集機器人,例如: 自動的郵件連結也很類似,只是 Markdown 會先做一個編碼轉換的過程,把文字字元轉成16進位碼的 HTML 實體,這樣的格式可以混淆一些不好的信箱地址收集機器人,例如:
<address@example.com> <address@example.com>
@ -676,7 +676,7 @@ Markdown 會轉成:
在瀏覽器裡面,這段字串會變成一個可以點擊的 "address@example.com" 連結。 在瀏覽器裡面,這段字串會變成一個可以點擊的 "address@example.com" 連結。
(這種作法雖然可以混淆不少的機器人,但並無法全部檔下來,不過這樣也比什麼都不做還好不管如何,公開你的信箱終究是會引來廣告信件的。) (這種作法雖然可以混淆不少的機器人,但並無法全部檔下來,不過這樣也比什麼都不做好些。無論如何,公開你的信箱終究是會引來廣告信件的。)
<h3 id="backslash">跳脫字元</h3> <h3 id="backslash">跳脫字元</h3>

Loading…
Cancel
Save