|
|
|
@ -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> |
|
|
|
|
|
|
|
|
|
|
|
@ -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> |
|
|
|
|
|
|
|
|
|
|
|
@ -108,9 +108,9 @@ This is another regular paragraph. |
|
|
|
|
|
|
|
|
|
|
|
<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> |
|
|
|
@ -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 /> |
|
|
|
|
|
|
|
|
|
|
|
@ -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 |
|
|
|
|
|
|
|
|
|
|
|
@ -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: |
|
|
|
|
|
|
|
|
|
|
|
@ -478,7 +478,7 @@ end tell |
|
|
|
|
|
|
|
|
|
|
|
<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> |
|
|
|
|
|
|
|
|
|
|
|
@ -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> |
|
|
|
@ -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> |
|
|
|
|
othree
11 years ago