|
|
@ -17,16 +17,16 @@ |
|
|
|
<nav> |
|
|
|
<nav> |
|
|
|
<a href="/">文件</a> |
|
|
|
<a href="/">文件</a> |
|
|
|
<a href="/resources.html">資源</a> |
|
|
|
<a href="/resources.html">資源</a> |
|
|
|
|
|
|
|
<a href="http://commonmark.org/">標準</a> |
|
|
|
<a href="https://github.com/othree/markdown-syntax-zhtw/issues">回報錯誤</a> |
|
|
|
<a href="https://github.com/othree/markdown-syntax-zhtw/issues">回報錯誤</a> |
|
|
|
</nav> |
|
|
|
</nav> |
|
|
|
|
|
|
|
|
|
|
|
<div class="wikistyle"> |
|
|
|
<div class="wikistyle"> |
|
|
|
|
|
|
|
|
|
|
|
<h1>Markdown文件</h1> |
|
|
|
<h1>Markdown文件</h1> |
|
|
|
|
|
|
|
|
|
|
|
<p><img src="http://markdown.tw/images/208x128.png" alt="Markdown" title="" /></p> |
|
|
|
<p><img src="http://markdown.tw/images/208x128.png" alt="Markdown" title="" /></p> |
|
|
|
|
|
|
|
|
|
|
|
<p lang="en"><strong>NOTE:</strong> This is Traditional Chinese Edition Document of |
|
|
|
<p><strong>NOTE:</strong> This is Traditional Chinese Edition Document of |
|
|
|
Markdown Syntax. If you are seeking for English Edition |
|
|
|
Markdown Syntax. If you are seeking for English Edition |
|
|
|
Document. Please refer to <a href="http://daringfireball.net/projects/markdown/syntax">Markdown: Syntax</a>.</p> |
|
|
|
Document. Please refer to <a href="http://daringfireball.net/projects/markdown/syntax">Markdown: Syntax</a>.</p> |
|
|
|
|
|
|
|
|
|
|
@ -36,7 +36,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s |
|
|
|
<li><a href="#overview">概述</a> |
|
|
|
<li><a href="#overview">概述</a> |
|
|
|
<ul> |
|
|
|
<ul> |
|
|
|
<li><a href="#philosophy">哲學</a></li> |
|
|
|
<li><a href="#philosophy">哲學</a></li> |
|
|
|
<li><a href="#html">行內HTML</a></li> |
|
|
|
<li><a href="#html">行內 HTML</a></li> |
|
|
|
<li><a href="#autoescape">特殊字元自動轉換</a></li> |
|
|
|
<li><a href="#autoescape">特殊字元自動轉換</a></li> |
|
|
|
</ul></li> |
|
|
|
</ul></li> |
|
|
|
<li><a href="#block">區塊元素</a> |
|
|
|
<li><a href="#block">區塊元素</a> |
|
|
@ -63,7 +63,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s |
|
|
|
<li><a href="#acknowledgement">感謝</a></li> |
|
|
|
<li><a href="#acknowledgement">感謝</a></li> |
|
|
|
</ul> |
|
|
|
</ul> |
|
|
|
|
|
|
|
|
|
|
|
<p><strong>注意:</strong>這份文件是用Markdown寫的,你可以<a href="https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md">看看它的原始檔</a>。</p> |
|
|
|
<p><strong>注意:</strong>這份文件是用Markdown寫的,你可以<a href="https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md">看看它的原始檔</a> 。</p> |
|
|
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<hr /> |
|
|
|
|
|
|
|
|
|
|
@ -73,7 +73,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s |
|
|
|
|
|
|
|
|
|
|
|
<p>Markdown的目標是實現「易讀易寫」。</p> |
|
|
|
<p>Markdown的目標是實現「易讀易寫」。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>不過最需要強調的便是它的可讀性。一份使用Markdown格式撰寫的文件應該可以直接以純文字發佈,並且看起來不會像是由許多標籤或是格式指令所構成。Markdown語法受到一些既有text-to-HTML格式的影響,包括<a href="http://docutils.sourceforge.net/mirror/setext.html">Setext</a>、<a href="http://www.aaronsw.com/2002/atx/">atx</a>、<a href="http://textism.com/tools/textile/">Textile</a>、<a href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>、<a href="http://www.triptico.com/software/grutatxt.html">Grutatext</a>和<a href="http://ettext.taint.org/doc/">EtText</a>,然而最大靈感來源其實是純文字的電子郵件格式。</p> |
|
|
|
<p>不過最需要強調的便是它的可讀性。一份使用Markdown格式撰寫的文件應該可以直接以純文字發佈,並且看起來不會像是由許多標籤或是格式指令所構成。Markdown語法受到一些既有text-to-HTML格式的影響,包括<a href="http://docutils.sourceforge.net/mirror/setext.html">Setext</a>、<a href="http://www.aaronsw.com/2002/atx/">atx</a>、<a href="http://textism.com/tools/textile/">Textile</a>、<a href="http://docutils.sourceforge.net/rst.html">reStructuredText</a>、<a href="http://www.triptico.com/software/grutatxt.html">Grutatext</a> 和 <a href="http://ettext.taint.org/doc/">EtText</a>,然而最大靈感來源其實是純文字的電子郵件格式。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>因此Markdown的語法全由標點符號所組成,並經過嚴謹慎選,是為了讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號,看起來就像*強調*。Markdown的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的像是引用一段文字。</p> |
|
|
|
<p>因此Markdown的語法全由標點符號所組成,並經過嚴謹慎選,是為了讓它們看起來就像所要表達的意思。像是在文字兩旁加上星號,看起來就像*強調*。Markdown的清單看起來,嗯,就是清單。假如你有使用過電子郵件,區塊引言看起來就真的像是引用一段文字。</p> |
|
|
|
|
|
|
|
|
|
|
@ -81,11 +81,11 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s |
|
|
|
|
|
|
|
|
|
|
|
<p>Markdown的語法有個主要的目的:用來作為一種網路內容的<em>寫作</em>用語言。</p> |
|
|
|
<p>Markdown的語法有個主要的目的:用來作為一種網路內容的<em>寫作</em>用語言。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>Markdown不是要來取代HTML,甚至也沒有要和它相似,它的語法種類不多,只和HTML的一部分有關係,重點<em>不是</em>要創造一種更容易寫作 HTML文件的語法,我認為HTML已經很容易寫了,Markdown的重點在於,它能讓文件更容易閱讀、編寫。HTML是一種<em>發佈</em>的格式,Markdown是一種<em>編寫</em>的格式,因此,Markdown的格式語法只涵蓋純文字可以涵蓋的範圍。</p> |
|
|
|
<p>Markdown不是要來取代HTML,甚至也沒有要和它相似,它的語法種類不多,只和HTML的一部分有關係,重點<em>不是</em>要創造一種更容易寫作HTML文件的語法,我認為HTML已經很容易寫了,Markdow的重點在於,它能讓文件更容易閱讀、編寫。HTML 是一種<em>發佈</em>的格式,Markdown是一種<em>編寫</em>的格式,因此,Markdown的格式語法只涵蓋純文字可以涵蓋的範圍。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>不在Markdown涵蓋範圍之外的標籤,都可以直接在文件裡面用HTML撰寫。不需要額外標註這是HTML或是Markdown——只要直接加標籤就可以了。</p> |
|
|
|
<p>不在Markdown涵蓋範圍之外的標籤,都可以直接在文件裡面用HTML撰寫。不需要額外標註這是HTML或是Markdown;只要直接加標籤就可以了。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>只有區塊元素——比如<code><div></code>、<code><table></code>、<code><pre></code>、<code><p></code>等標籤——必需在前後加上空行,以利與內容區隔。而且這些元素的開始與結尾標籤,不可以用tab或是空白來縮排。Markdown的產生器有智慧型判斷,可以避免在區塊標籤前後加上沒有必要的<code><p></code>標籤。</p> |
|
|
|
<p>只有區塊元素──比如<code><div></code>、<code><table></code>、<code><pre></code>、<code><p></code>等標籤,必需在前後加上空行,以利與內容區隔。而且這些(元素)的開始與結尾標籤,不可以用tab或是空白來縮排。Markdown的產生器有智慧型判斷,可以避免在區塊標籤前後加上沒有必要的<code><p></code>標籤。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>舉例來說,在Markdown文件裡加上一段HTML表格:</p> |
|
|
|
<p>舉例來說,在Markdown文件裡加上一段HTML表格:</p> |
|
|
|
|
|
|
|
|
|
|
@ -102,15 +102,15 @@ This is another regular paragraph. |
|
|
|
|
|
|
|
|
|
|
|
<p>請注意,Markdown語法在HTML區塊標籤中將不會被進行處理。例如,你無法在HTML區塊內使用Markdown形式的<code>*強調*</code>。</p> |
|
|
|
<p>請注意,Markdown語法在HTML區塊標籤中將不會被進行處理。例如,你無法在HTML區塊內使用Markdown形式的<code>*強調*</code>。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>HTML的區段標籤如<code><span></code>、<code><cite></code>、<code><del></code>則不受限制,可以在Markdown的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown格式,而採用HTML標籤來格式化。舉例說明:如果比較喜歡 HTML的<code><a></code>或<code><img></code>標籤,可以直接使用這些標籤,而不用Markdown提供的連結或是影像標示語法。</p> |
|
|
|
<p>HTML的區段標籤如<code><span></code>、<code><cite></code>、<code><del></code>則不受限制,可以在Markdown的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown格式,而採用HTML標籤來格式化。舉例說明:如果比較喜歡HTML的 <code><a></code>或<code><img></code>標籤,可以直接使用這些標籤,而不用Markdown提供的連結或是影像標示語法。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>HTML區段標籤和區塊標籤不同,在區段標籤的範圍內,Markdown的語法是有效的。</p> |
|
|
|
<p>HTML區段標籤和區塊標籤不同,在區段標籤的範圍內,Markdown的語法是有效的。</p> |
|
|
|
|
|
|
|
|
|
|
|
<h3 id="autoescape">特殊字元自動轉換</h3> |
|
|
|
<h3 id="autoescape">特殊字元自動轉換</h3> |
|
|
|
|
|
|
|
|
|
|
|
<p>在HTML文件中,有兩個字元需要特殊處理:<code><</code>和<code>&</code>。<code><</code>符號用於起始標籤,<code>&</code>符號則用於標記HTML實體,如果你只是想要使用這些符號,你必須要使用實體的形式,像是<code>&lt;</code>和<code>&amp;</code>。</p> |
|
|
|
<p>在HTML文件中,有兩個字元需要特殊處理:<code><</code>和<code>&</code>。<code><</code>符號用於起始標籤<code>&</code>符號則用於標記HTML實體,如果你只是想要使用這些符號,你必須要使用實體的形式,像是<code>&lt;</code>和<code>&amp;</code>。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p><code>&</code>符號其實很讓寫作網路文件的人感到困擾,如果你要打「AT&T」,你必須要寫成「<code>AT&amp;T</code>」,還得轉換網址內的<code>&</code>符號,如果你要連結到:</p> |
|
|
|
<p><code>&</code> 符號其實很容易讓寫作網路文件的人感到困擾,如果你要打「AT&T」 ,你必須要寫成「<code>AT&amp;T</code>」 ,還得轉換網址內的 <code>&</code> 符號,如果你要連結到:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code>http://images.google.com/images?num=30&q=larry+bird |
|
|
|
<pre><code>http://images.google.com/images?num=30&q=larry+bird |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
@ -137,7 +137,7 @@ This is another regular paragraph. |
|
|
|
<pre><code>AT&amp;T |
|
|
|
<pre><code>AT&amp;T |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p>類似的狀況也會發生在<code><</code>符號上,因為Markdown支援<a href="#html">行內HTML</a>,如果你是使用<code><</code>符號作為HTML標籤使用,那Markdown也不會對它做任何轉換,但是如果你是寫:</p> |
|
|
|
<p>類似的狀況也會發生在<code><</code>符號上,因為Markdown支援<a href="#html">行內 HTML</a> ,如果你是使用<code><</code>符號作為HTML標籤使用,那Markdown也不會對它做任何轉換,但是如果你是寫:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code>4 < 5 |
|
|
|
<pre><code>4 < 5 |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
@ -147,7 +147,7 @@ This is another regular paragraph. |
|
|
|
<pre><code>4 &lt; 5 |
|
|
|
<pre><code>4 &lt; 5 |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p>不過需要注意的是,code範圍內,不論是行內還是區塊,<code><</code>和<code>&</code>兩個符號都<em>一定</em>會被轉換成HTML實體,這項特性讓你可以很容易地用Markdown寫HTML code(和HTML相對而言, HTML語法中,你要把所有的<code><</code>和<code>&</code>都轉換為HTML實體,才能在HTML文件裡面寫出HTML code。)</p> |
|
|
|
<p>不過需要注意的是,code範圍內,不論是行內還是區塊,<code><</code>和<code>&</code>兩個符號都<em>一定</em>會被轉換成HTML實體,這項特性讓你可以很容易地用Markdown寫HTML code(和HTML相對而言。在HTML語法中,你要把所有的<code><</code>和<code>&</code>都轉換為 HTML實體,才能在HTML文件裡面寫出HTML code。)</p> |
|
|
|
|
|
|
|
|
|
|
|
<hr /> |
|
|
|
<hr /> |
|
|
|
|
|
|
|
|
|
|
@ -161,7 +161,7 @@ This is another regular paragraph. |
|
|
|
|
|
|
|
|
|
|
|
<p>如果你<em>真的</em>想要插入<code><br /></code>標籤的話,在行尾加上兩個以上的空白,然後按enter。</p> |
|
|
|
<p>如果你<em>真的</em>想要插入<code><br /></code>標籤的話,在行尾加上兩個以上的空白,然後按enter。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>是的,這確實需要花比較多功夫來插入<code><br /></code>,但是「每個換行都轉換為<code><br /></code>」的方法在 Markdown中並不適合,Markdown中email式的<a href="#blockquote">區塊引言</a>和多段落的<a href="#list">清單</a>在使用換行來排版的時候,不但更好用,還更好閱讀。</p> |
|
|
|
<p>是的,這確實需要花比較多功夫來插入<code><br /></code>,但是「每個換行都轉換為<code><br /></code>」的方法在Markdown中並不適合, Markdown中email式的<a href="#blockquote">區塊引言</a>和多段落的<a href="#list">清單</a>在使用換行來排版的時候,不但更好用,還更好閱讀。</p> |
|
|
|
|
|
|
|
|
|
|
|
<h3 id="header">標題</h3> |
|
|
|
<h3 id="header">標題</h3> |
|
|
|
|
|
|
|
|
|
|
@ -178,7 +178,7 @@ This is an H2 |
|
|
|
|
|
|
|
|
|
|
|
<p>任何數量的<code>=</code>和<code>-</code>都可以有效果。</p> |
|
|
|
<p>任何數量的<code>=</code>和<code>-</code>都可以有效果。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>Atx形式則是在行首插入1至6個<code>#</code>,對應到標題1到6階,例如:</p> |
|
|
|
<p>Atx形式則是在行首插入1到6個 <code>#</code> ,各對應到標題1到6階,例如:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code># This is an H1 |
|
|
|
<pre><code># This is an H1 |
|
|
|
|
|
|
|
|
|
|
@ -320,7 +320,7 @@ viverra nec, fringilla in, laoreet vitae, risus. |
|
|
|
Suspendisse id sem consectetuer libero luctus adipiscing. |
|
|
|
Suspendisse id sem consectetuer libero luctus adipiscing. |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p>如果清單項目間用空行分開,Markdown會把項目的內容在輸出時用<code><p></code>標籤包起來,舉例來說:</p> |
|
|
|
<p>如果清單項目間用空行分開, Markdown會把項目的內容在輸出時用<code><p></code>標籤包起來,舉例來說:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code>* Bird |
|
|
|
<pre><code>* Bird |
|
|
|
* Magic |
|
|
|
* Magic |
|
|
@ -349,7 +349,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing. |
|
|
|
</ul> |
|
|
|
</ul> |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p>清單項目可以包含多個段落,每個項目下的段落都必須縮排4個空白或是一個tab :</p> |
|
|
|
<p>清單項目可以包含多個段落,每個項目下的段落都必須縮排4個空白或是一個tab:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code>1. This is a list item with two paragraphs. Lorem ipsum dolor |
|
|
|
<pre><code>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 |
|
|
@ -417,7 +417,7 @@ sit amet, consectetuer adipiscing elit. |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p>這個每行一階的縮排(4個空白或是tab),都會被移除,例如:</p> |
|
|
|
<p>這個每行一階的縮排(4個空白或是1個tab),都會被移除,例如:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code>Here is an example of AppleScript: |
|
|
|
<pre><code>Here is an example of AppleScript: |
|
|
|
|
|
|
|
|
|
|
@ -438,7 +438,7 @@ end tell |
|
|
|
|
|
|
|
|
|
|
|
<p>一個程式碼區塊會一直持續到沒有縮排的那一行(或是文件結尾)。</p> |
|
|
|
<p>一個程式碼區塊會一直持續到沒有縮排的那一行(或是文件結尾)。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>在程式碼區塊裡面,<code>&</code>、<code><</code>和<code>></code>會自動轉成HTML實體,這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼,只需要複製貼上,再加上縮排就可以了,剩下的 Markdown都會幫你處理,例如:</p> |
|
|
|
<p>在程式碼區塊裡面,<code>&</code>、<code><</code>和<code>></code>會自動轉成HTML實體,這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼,只需要複製貼上,再加上縮排就可以了,剩下的Markdown都會幫你處理,例如:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code> <div class="footer"> |
|
|
|
<pre><code> <div class="footer"> |
|
|
|
&copy; 2004 Foo Corporation |
|
|
|
&copy; 2004 Foo Corporation |
|
|
@ -476,9 +476,9 @@ end tell |
|
|
|
|
|
|
|
|
|
|
|
<h3 id="link">連結</h3> |
|
|
|
<h3 id="link">連結</h3> |
|
|
|
|
|
|
|
|
|
|
|
<p>Markdown支援兩種形式的連結語法: <em>行內</em>和<em>參考</em>兩種形式。</p> |
|
|
|
<p>Markdown支援兩種形式的連結語法:<em>行內</em>和<em>參考</em>兩種形式。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>不管是哪一種,連結的文字都是用<code>[方括號]</code>來標記。</p> |
|
|
|
<p>不管是哪一種,連結的文字都是用 [方括號] 來標記。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>要建立一個行內形式的連結,只要在方塊括號後面馬上接著括號並插入網址連結即可,如果你還想要加上連結的title文字,只要在網址後面,用雙引號把title文字包起來即可,例如:</p> |
|
|
|
<p>要建立一個行內形式的連結,只要在方塊括號後面馬上接著括號並插入網址連結即可,如果你還想要加上連結的title文字,只要在網址後面,用雙引號把title文字包起來即可,例如:</p> |
|
|
|
|
|
|
|
|
|
|
@ -521,9 +521,9 @@ title attribute.</p> |
|
|
|
<ul> |
|
|
|
<ul> |
|
|
|
<li>方括號,裡面輸入連結的辨識用標籤</li> |
|
|
|
<li>方括號,裡面輸入連結的辨識用標籤</li> |
|
|
|
<li>接著一個冒號</li> |
|
|
|
<li>接著一個冒號</li> |
|
|
|
<li>接著一個以上的空白或 tab</li> |
|
|
|
<li>接著一個以上的空白或tab</li> |
|
|
|
<li>接著連結的網址</li> |
|
|
|
<li>接著連結的網址</li> |
|
|
|
<li>選擇性地接著 title 內容,可以用單引號、雙引號或是括弧包著</li> |
|
|
|
<li>選擇性地接著title內容,可以用單引號、雙引號或是括弧包著</li> |
|
|
|
</ul> |
|
|
|
</ul> |
|
|
|
|
|
|
|
|
|
|
|
<p>下面這三種連結的定義都是相同:</p> |
|
|
|
<p>下面這三種連結的定義都是相同:</p> |
|
|
@ -554,7 +554,7 @@ title attribute.</p> |
|
|
|
[link text][A] |
|
|
|
[link text][A] |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p><em>預設的連結標籤</em>功能讓你可以省略指定連結標籤,這種情形下,連結標籤和連結文字會視為相同,要用預設連結標籤只要在連結文字後面加上一個空的方括號,如果你要讓「Google」連結到google.com,你可以簡化成:</p> |
|
|
|
<p><em>預設的連結標籤</em>功能讓你可以省略指定連結標籤,這種情形下,連結標籤和連結文字會視為相同,要用預設連結標籤只要在連結文字後面加上一個空的方括號,如果你要讓"Google"連結到google.com,你可以簡化成:</p> |
|
|
|
|
|
|
|
|
|
|
|
<pre><code>[Google][] |
|
|
|
<pre><code>[Google][] |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
@ -611,7 +611,7 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or |
|
|
|
[MSN](http://search.msn.com/ "MSN Search"). |
|
|
|
[MSN](http://search.msn.com/ "MSN Search"). |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p>參考式的連結其實重點不在於它比較好寫,而是它比較好讀,比較一下上面的範例,使用參考式的文章本身只有 81 個字元,但是用行內形式的連結卻會增加到176個字元,如果是用純HTML格式來寫,會有234個字元,在HTML格式中,標籤比文字還要多。</p> |
|
|
|
<p>參考式的連結其實重點不在於它比較好寫,而是它比較好讀,比較一下上面的範例,使用參考式的文章本身只有81個字元,但是用行內形式的連結卻會增加到176個字元,如果是用純HTML格式來寫,會有234個字元,在HTML格式中,標籤比文字還要多。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>使用Markdown的參考式連結,可以讓文件更像是瀏覽器最後產生的結果,讓你可以把一些標記相關的資訊移到段落文字之外,你就可以增加連結而不讓文章的閱讀感覺被打斷。</p> |
|
|
|
<p>使用Markdown的參考式連結,可以讓文件更像是瀏覽器最後產生的結果,讓你可以把一些標記相關的資訊移到段落文字之外,你就可以增加連結而不讓文章的閱讀感覺被打斷。</p> |
|
|
|
|
|
|
|
|
|
|
@ -646,7 +646,7 @@ __double underscores__ |
|
|
|
<pre><code>un*frigging*believable |
|
|
|
<pre><code>un*frigging*believable |
|
|
|
</code></pre> |
|
|
|
</code></pre> |
|
|
|
|
|
|
|
|
|
|
|
<p>但是如果你的<code>*</code>和<code>_</code>兩邊都有空白的話,它們就只會被當成普通的符號。</p> |
|
|
|
<p>但是如果你的 <code>*</code> 和 <code>_</code> 兩邊都有空白的話,它們就只會被當成普通的符號。</p> |
|
|
|
|
|
|
|
|
|
|
|
<p>如果要在文字前後直接插入普通的星號或底線,你可以用反斜線:</p> |
|
|
|
<p>如果要在文字前後直接插入普通的星號或底線,你可以用反斜線:</p> |
|
|
|
|
|
|
|
|
|
|
@ -728,7 +728,8 @@ equivalent of <code>&amp;mdash;</code>.</p> |
|
|
|
<ul> |
|
|
|
<ul> |
|
|
|
<li>一個驚嘆號<code>!</code></li> |
|
|
|
<li>一個驚嘆號<code>!</code></li> |
|
|
|
<li>接著一個方括號,裡面放上圖片的替代文字</li> |
|
|
|
<li>接著一個方括號,裡面放上圖片的替代文字</li> |
|
|
|
<li>接著一個普通括號,裡面放上圖片的網址,最後還可以用引號包住並加上選擇性的'title'文字。</li> |
|
|
|
<li>接著一個普通括號,裡面放上圖片的網址,最後還可以用引號包住並加上 |
|
|
|
|
|
|
|
選擇性的'title'文字。</li> |
|
|
|
</ul> |
|
|
|
</ul> |
|
|
|
|
|
|
|
|
|
|
|
<p>參考式的圖片語法則長得像這樣:</p> |
|
|
|
<p>參考式的圖片語法則長得像這樣:</p> |
|
|
@ -801,10 +802,10 @@ _ 底線 |
|
|
|
|
|
|
|
|
|
|
|
<h2 id="acknowledgement">感謝</h2> |
|
|
|
<h2 id="acknowledgement">感謝</h2> |
|
|
|
|
|
|
|
|
|
|
|
<p>感謝<a href="https://twitter.com/#!/leafy7382">leafy7382</a>協助翻譯,<a href="http://iamhlb.com/">hlb</a>、<a href="http://twitter.com/randylien">Randylien</a>幫忙潤稿,<a href="https://twitter.com/#!/ethantw">ethantw</a>的<a href="http://css.hanzi.co/">漢字標準格式</a>(Han.css),<a href="http://kidwm.net/">WM</a>回報文字錯誤。</p> |
|
|
|
<p>感謝<a href="https://twitter.com/#!/leafy7382">leafy7382</a>協助翻譯,<a href="http://iamhlb.com/">hlb</a>、<a href="http://twitter.com/randylien">Randylien</a>幫忙潤稿,<a href="https://twitter.com/#!/ethantw">ethantw</a>的<a href="http://css.hanzi.co/">漢字標準格式</a>,<a href="http://kidwm.net/">WM</a>回報文字錯誤。</p> |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div><!-- /div.wikistyle --> |
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
|
|
<div id="comments"> |
|
|
|
<div id="comments"> |
|
|
|
|
|
|
|
|
|
|
@ -828,7 +829,7 @@ _ 底線 |
|
|
|
|
|
|
|
|
|
|
|
</div> |
|
|
|
</div> |
|
|
|
|
|
|
|
|
|
|
|
<script> |
|
|
|
<script type="text/javascript"> |
|
|
|
var _gaq = _gaq || []; |
|
|
|
var _gaq = _gaq || []; |
|
|
|
_gaq.push(['_setAccount', 'UA-21880461-1']); |
|
|
|
_gaq.push(['_setAccount', 'UA-21880461-1']); |
|
|
|
_gaq.push(['_trackPageview']); |
|
|
|
_gaq.push(['_trackPageview']); |
|
|
@ -839,6 +840,7 @@ _ 底線 |
|
|
|
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); |
|
|
|
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); |
|
|
|
})(); |
|
|
|
})(); |
|
|
|
</script> |
|
|
|
</script> |
|
|
|
|
|
|
|
|
|
|
|
<script src="/js/jquery-2.0.3.min.js"></script> |
|
|
|
<script src="/js/jquery-2.0.3.min.js"></script> |
|
|
|
<script src="js/han.js"></script> |
|
|
|
<script src="js/han.js"></script> |
|
|
|
</body> |
|
|
|
</body> |
|
|
|