特殊字元自動轉換
-在HTML文件中,有兩個字元需要特殊處理:<
和&
。<
符號用於起始標籤,&
符號則用於標記HTML實體,如果你只是想要使用這些符號,你必須要使用實體的形式,像是<
和&
。
+在 HTML 文件中,有兩個字元需要特殊處理: <
和 &
。 <
符號用於起始標籤,&
符號則用於標記 HTML 實體,如果你只是想要使用這些符號,你必須要使用實體的形式,像是 <
和 &
。
-&
符號其實很讓寫作網路文件的人感到困擾,如果你要打「AT&T」,你必須要寫成「AT&T
」,還得轉換網址內的&
符號,如果你要連結到:
+&
符號其實很讓寫作網路文件的人感到困擾,如果你要打「AT&T」 ,你必須要寫成「AT&T
」 ,還得轉換網址內的 &
符號,如果你要連結到:
http://images.google.com/images?num=30&q=larry+bird
@@ -96,34 +96,34 @@ This is another regular paragraph.
http://images.google.com/images?num=30&q=larry+bird
-才能放到連結標籤的href
屬性裡。不用說也知道這很容易忘記,這也可能是HTML標準檢查所檢查到的錯誤中,數量最多的。
+才能放到連結標籤的 href
屬性裡。不用說也知道這很容易忘記,這也可能是 HTML 標準檢查所檢查到的錯誤中,數量最多的。
-Markdown允許你直接使用這些符號,但是你要小心跳脫字元的使用,如果你是在HTML實體中使用&
符號的話,它不會被轉換,而在其他情形下,它則會被轉換成&
。所以你如果要在文件中插入一個著作權的符號,你可以這樣寫:
+Markdown 允許你直接使用這些符號,但是你要小心跳脫字元的使用,如果你是在HTML 實體中使用 &
符號的話,它不會被轉換,而在其它情形下,它則會被轉換成 &
。所以你如果要在文件中插入一個著作權的符號,你可以這樣寫:
©
-Markdown將不會對這段文字做修改,但是如果你這樣寫:
+Markdown 將不會對這段文字做修改,但是如果你這樣寫:
AT&T
-Markdown就會將它轉為:
+Markdown 就會將它轉為:
AT&T
-類似的狀況也會發生在<
符號上,因為Markdown支援行內HTML,如果你是使用<
符號作為HTML標籤使用,那Markdown也不會對它做任何轉換,但是如果你是寫:
+類似的狀況也會發生在 <
符號上,因為 Markdown 支援 行內 HTML ,如果你是使用 <
符號作為 HTML 標籤使用,那 Markdown 也不會對它做任何轉換,但是如果你是寫:
4 < 5
-Markdown將會把它轉換為:
+Markdown 將會把它轉換為:
4 < 5
-不過需要注意的是,code範圍內,不論是行內還是區塊,<
和&
兩個符號都一定會被轉換成HTML實體,這項特性讓你可以很容易地用Markdown寫HTML code(和HTML相對而言, HTML語法中,你要把所有的<
和&
都轉換為HTML實體,才能在HTML文件裡面寫出HTML code。)
+不過需要注意的是,code 範圍內,不論是行內還是區塊, <
和 &
兩個符號都一定會被轉換成 HTML 實體,這項特性讓你可以很容易地用 Markdown 寫 HTML code (和 HTML 相對而言, HTML 語法中,你要把所有的 <
和 &
都轉換為 HTML 實體,才能在 HTML 文件裡面寫出 HTML code。)
@@ -131,19 +131,19 @@ This is another regular paragraph.
段落和換行
-一個段落是由一個以上相連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,便會被視為空行。比方說,若某一行只包含空白和tab,則該行也會被視為空行),一般的段落不需要用空白或斷行縮排。
+一個段落是由一個以上相連接的行句組成,而一個以上的空行則會切分出不同的段落(空行的定義是顯示上看起來像是空行,便會被視為空行。比方說,若某一行只包含空白和 tab,則該行也會被視為空行),一般的段落不需要用空白或斷行縮排。
-「一個以上相連接的行句組成」這句話其實暗示了Markdown允許段落內的強迫斷行,這個特性和其他大部分的text-to-HTML格式不一樣(包括 MovableType的「Convert Line Breaks」選項),其他的格式會把每個斷行都轉成<br />
標籤。
+「一個以上相連接的行句組成」這句話其實暗示了 Markdown 允許段落內的強迫斷行,這個特性和其他大部分的 text-to-HTML 格式不一樣(包括 MovableType 的「Convert Line Breaks」選項),其它的格式會把每個斷行都轉成 <br />
標籤。
-如果你真的想要插入<br />
標籤的話,在行尾加上兩個以上的空白,然後按enter。
+如果你真的想要插入 <br />
標籤的話,在行尾加上兩個以上的空白,然後按 enter。
-是的,這確實需要花比較多功夫來插入<br />
,但是「每個換行都轉換為<br />
」的方法在 Markdown中並不適合,Markdown中email式的區塊引言和多段落的清單在使用換行來排版的時候,不但更好用,還更好閱讀。
+是的,這確實需要花比較多功夫來插入 <br />
,但是「每個換行都轉換為 <br />
」的方法在 Markdown 中並不適合, Markdown 中 email 式的 區塊引言 和多段落的 清單 在使用換行來排版的時候,不但更好用,還更好閱讀。
-Markdown支援兩種標題的語法,Setext和atx形式。
+Markdown 支援兩種標題的語法,Setext 和 atx 形式。
-Setext形式是用底線的形式,利用=
(最高階標題)和-
(第二階標題),例如:
+Setext 形式是用底線的形式,利用 =
(最高階標題)和 -
(第二階標題),例如:
This is an H1
=============
@@ -152,9 +152,9 @@ This is an H2
-------------
-任何數量的=
和-
都可以有效果。
+任何數量的 =
和 -
都可以有效果。
-Atx形式則是在行首插入1至6個#
,對應到標題1到6階,例如:
+Atx 形式則是在行首插入 1 到 6 個 #
,對應到標題 1 到 6 階,例如:
# This is an H1
@@ -163,7 +163,7 @@ This is an H2
###### This is an H6
-你可以選擇性地「關閉」atx樣式的標題,這純粹只是美觀用的,若是覺得這樣看起來比較舒適,你就可以在行尾加上#
,而行尾的#
數量也不用和開頭一樣(行首的井字數量決定標題的階數):
+你可以選擇性地「關閉」atx 樣式的標題,這純粹只是美觀用的,若是覺得這樣看起來比較舒適,你就可以在行尾加上 #
,而行尾的 #
數量也不用和開頭一樣(行首的井字數量決定標題的階數):
# This is an H1 #
@@ -174,7 +174,7 @@ This is an H2
Blockquotes
-Markdown使用email形式的區塊引言,如果你很熟悉如何在email信件中引言,你就知道怎麼在Markdown文件中建立一個區塊引言,那會看起來像是你強迫斷行,然後在每行的最前面加上>
:
+Markdown 使用 email 形式的區塊引言,如果你很熟悉如何在 email 信件中引言,你就知道怎麼在 Markdown 文件中建立一個區塊引言,那會看起來像是你強迫斷行,然後在每行的最前面加上 >
:
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
@@ -184,7 +184,7 @@ This is an H2
> id sem consectetuer libero luctus adipiscing.
-Markdown也允許你只在整個段落的第一行最前面加上>
:
+Markdown 也允許你只在整個段落的第一行最前面加上 >
:
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
@@ -194,7 +194,7 @@ Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
id sem consectetuer libero luctus adipiscing.
-區塊引言可以有階層(例如:引言內的引言),只要根據層數加上不同數量的>
:
+區塊引言可以有階層(例如:引言內的引言),只要根據層數加上不同數量的 >
:
> This is the first level of quoting.
>
@@ -203,7 +203,7 @@ id sem consectetuer libero luctus adipiscing.
> Back to the first level.
-引言的區塊內也可以使用其他的Markdown語法,包括標題、清單、程式碼區塊等:
+引言的區塊內也可以使用其他的 Markdown 語法,包括標題、清單、程式碼區塊等:
> ## This is a header.
>
@@ -215,11 +215,11 @@ id sem consectetuer libero luctus adipiscing.
> return shell_exec("echo $input | $markdown_script");
-任何標準的文字編輯器都能簡單地建立email樣式的引言,例如BBEdit,你可以選取文字後然後從選單中選擇增加引言階層。
+任何標準的文字編輯器都能簡單地建立 email 樣式的引言,例如 BBEdit ,你可以選取文字後然後從選單中選擇增加引言階層。
清單
-Markdown支援有序清單和無序清單。
+Markdown 支援有序清單和無序清單。
無序清單使用星號、加號或是減號作為清單標記:
@@ -249,7 +249,7 @@ id sem consectetuer libero luctus adipiscing.
3. Parish
-很重要的一點是,你在清單標記上使用的數字並不會影響輸出的HTML結果,上面的清單所產生的HTML標記為:
+很重要的一點是,你在清單標記上使用的數字並不會影響輸出的 HTML 結果,上面的清單所產生的 HTML 標記為:
<ol>
<li>Bird</li>
@@ -272,11 +272,11 @@ id sem consectetuer libero luctus adipiscing.
8. Parish
-你都會得到完全相同的HTML輸出。重點在於,你可以讓Markdown文件的清單數字和輸出的結果相同,或是你懶一點,你可以完全不用在意數字的正確性。
+你都會得到完全相同的 HTML 輸出。重點在於,你可以讓 Markdown 文件的清單數字和輸出的結果相同,或是你懶一點,你可以完全不用在意數字的正確性。
-如果你使用懶惰的寫法,建議第一個項目最好還是從「1.」開始,因為Markdown未來可能會支援有序清單的start屬性。
+如果你使用懶惰的寫法,建議第一個項目最好還是從 1. 開始,因為 Markdown 未來可能會支援有序清單的 start 屬性。
-清單項目標記通常是放在最左邊,但是其實也可以縮排,最多三個空白,項目標記後面則一定要接著至少一個空白或tab。
+清單項目標記通常是放在最左邊,但是其實也可以縮排,最多三個空白,項目標記後面則一定要接著至少一個空白或 tab。
要讓清單看起來更漂亮,你可以把內容用固定的縮排整理好:
@@ -296,7 +296,8 @@ viverra nec, fringilla in, laoreet vitae, risus.
Suspendisse id sem consectetuer libero luctus adipiscing.