Compare commits

..

57 Commits

Author SHA1 Message Date
othree 501db6554c
Add reddit binding 5 years ago
othree dc34249f45
Add external link icon 5 years ago
othree bac6a5d96f
Add articles 5 years ago
othree 21e5829fe7
Fix resource.html 5 years ago
othree b3581562c5
Add pulldown-cmark 5 years ago
othree 76d37d7dc2
Gen html 6 years ago
othree a4cd518b53
Add reddit, comark 6 years ago
othree 2dbe19d6d1
Add API Blueprint and MSON 6 years ago
othree fd9adfc473 Add another GFM 7 years ago
othree 1db5a634e9 Fix logo 7 years ago
othree c2b567f238 Fix logo 7 years ago
othree 2745fd9e88 Reorganize Makefile 7 years ago
othree 7c929fe428 Regen 7 years ago
othree f5b0ffb186 Fix han.js 7 years ago
othree 549d66a211 Add footer 7 years ago
othree 56fb6c19cc Add jsx related projects 7 years ago
othree 09a9564b72 Add remarkable 7 years ago
othree c72427bb15 Add resouce 7 years ago
othree fbf02d5a19 HTTPS 7 years ago
othree c2b1c1cff8 Use https 7 years ago
othree 1b343de229 Create CNAME 7 years ago
othree 0d3e2f82ac Delete CNAME 7 years ago
othree 07d92263c8 Add python engine 8 years ago
othree a85cbb925f Update resource 8 years ago
othree c2e2d334b3 Update pagedown url 8 years ago
othree b315062020 Add cmark and commonmark.js 8 years ago
othree 6961920596 Add GFM spec link 8 years ago
othree 5190fe70e9 Fix '角括號' 8 years ago
othree 1377c8e63c Add FB group 9 years ago
othree 76dc46ecd5 Add marp 9 years ago
othree 3da2bbba63 Update default font 9 years ago
othree 2a5fac04a7 Add editor 10 years ago
othree 4b6c793be2 Update hans 10 years ago
othree b5dd8aec30 Hans 10 years ago
othree 250f159024 Try typekit 10 years ago
othree 79e775b535 Add CommonMark to engine list 11 years ago
othree bb06994f36 Add reMArked.js 11 years ago
othree 536138b978 Add stuff 11 years ago
othree 20257df188 Merge branch 'master' into gh-pages 11 years ago
othree 976e4cc358 Merge pull request #12 from 0x142857/master 11 years ago
0x142857 78fc803355 Add Miu 11 years ago
othree b9b808de3a Add common mark 11 years ago
othree 57249f9103 Merge pull request #10 from kewangtw/master 11 years ago
kewang 130a87d86f add UberWriter to resources 11 years ago
kewang 321bef5157 必需 => 必須 11 years ago
othree 1c27b6c5b3 Merge branch 'master' into gh-pages 11 years ago
othree f15f5c32e8 Update resources 11 years ago
othree 435fce81da Merge branch 'master' into gh-pages 11 years ago
othree c5f39e3193 Merge pull request #9 from louis378/patch-1 11 years ago
louis378 e967c1ba0d 修正第91行 11 years ago
othree_kao d1349672e9 Upgrade han.js 12 years ago
othree_kao 851f31b94c Revert "Performance issue" 12 years ago
othree_kao fdb0e84f89 Performance issue 12 years ago
othree 5fd4844eb6 Merge pull request #7 from wdv4758h/patch-1 12 years ago
dv 930b558ae1 Add browser extension "Markdown Here" 12 years ago
othree 0fe58026ec Merge pull request #6 from JuanitoFatas/master 12 years ago
Juanito Fatas 68ed2ec6e3 Add a Markdown editor for OSX: Kobito by Qiita 12 years ago
  1. 3
      .gitmodules
  2. 2
      CNAME
  3. 18
      Makefile
  4. 68
      content.html
  5. 1
      external-link-alt-solid.svg
  6. 42
      footer.html
  7. 20
      general_footer.html
  8. 23
      header.html
  9. 819
      index.html
  10. 1225
      js/han.js
  11. 6
      js/jquery-2.0.3.min.js
  12. 262
      resources.html
  13. 149
      resources.md
  14. 77
      resources_content.html
  15. 26
      stylesheets/main.css
  16. 10
      syntax.md
  17. 83
      template.html

3
.gitmodules vendored

@ -1,3 +0,0 @@ @@ -1,3 +0,0 @@
[submodule "Han"]
path = Han
url = git://github.com/ethantw/Han.git

2
CNAME

@ -1 +1 @@ @@ -1 +1 @@
markdown.tw
markdown.tw

18
Makefile

@ -1,17 +1,9 @@ @@ -1,17 +1,9 @@
all: index.html resources.html
.PHONY: all
index.html: header.html footer.html content.html
cat header.html content.html footer.html > index.html
index.html: template.html syntax.md
cat template.html | perl -pe 's/\{\{\ *CONTENT\ *\}\}/`pandoc syntax.md`/ge' > index.html
resources.html: header.html general_footer.html resources_content.html
cat header.html resources_content.html general_footer.html > resources.html
content.html: syntax.md
perl Markdown_1.0.1/Markdown.pl syntax.md > content.html
resources_content.html: resources.md
perl Markdown_1.0.1/Markdown.pl resources.md > resources_content.html
clean:
rm index.html resources.html content.html resources_content.html
resources.html: template.html resources.md
cat template.html | perl -pe 's/\{\{\ *CONTENT\ *\}\}/`pandoc resources.md`/ge' > resources.html

68
content.html

@ -1,8 +1,8 @@ @@ -1,8 +1,8 @@
<h1>Markdown文件</h1>
<p><img src="http://markdown.tw/images/208x128.png" alt="Markdown" title="" /></p>
<p><img src="https://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
Document. Please refer to <a href="http://daringfireball.net/projects/markdown/syntax">Markdown: Syntax</a>.</p>
@ -12,7 +12,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s @@ -12,7 +12,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
<li><a href="#overview">概述</a>
<ul>
<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>
</ul></li>
<li><a href="#block">區塊元素</a>
@ -39,7 +39,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s @@ -39,7 +39,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
<li><a href="#acknowledgement">感謝</a></li>
</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 />
@ -49,7 +49,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s @@ -49,7 +49,7 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
<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>
@ -57,11 +57,11 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s @@ -57,11 +57,11 @@ Document. Please refer to <a href="http://daringfireball.net/projects/markdown/s
<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>&lt;div&gt;</code><code>&lt;table&gt;</code><code>&lt;pre&gt;</code><code>&lt;p&gt;</code>等標籤——必需在前後加上空行,以利與內容區隔。而且這些元素的開始與結尾標籤,不可以用tab或是空白來縮排。Markdown的產生器有智慧型判斷,可以避免在區塊標籤前後加上沒有必要的<code>&lt;p&gt;</code>標籤。</p>
<p>只有區塊元素──比如<code>&lt;div&gt;</code><code>&lt;table&gt;</code><code>&lt;pre&gt;</code><code>&lt;p&gt;</code>等標籤必需在前後加上空行,以利與內容區隔。而且這些元素的開始與結尾標籤,不可以用tab或是空白來縮排。Markdown的產生器有智慧型判斷,可以避免在區塊標籤前後加上沒有必要的<code>&lt;p&gt;</code>標籤。</p>
<p>舉例來說,在Markdown文件裡加上一段HTML表格:</p>
@ -78,15 +78,15 @@ This is another regular paragraph. @@ -78,15 +78,15 @@ This is another regular paragraph.
<p>請注意,Markdown語法在HTML區塊標籤中將不會被進行處理。例如,你無法在HTML區塊內使用Markdown形式的<code>*強調*</code></p>
<p>HTML的區段標籤如<code>&lt;span&gt;</code><code>&lt;cite&gt;</code><code>&lt;del&gt;</code>則不受限制,可以在Markdown的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown格式,而採用HTML標籤來格式化。舉例說明:如果比較喜歡 HTML的<code>&lt;a&gt;</code><code>&lt;img&gt;</code>標籤,可以直接使用這些標籤,而不用Markdown提供的連結或是影像標示語法。</p>
<p>HTML的區段標籤如<code>&lt;span&gt;</code><code>&lt;cite&gt;</code><code>&lt;del&gt;</code>則不受限制,可以在Markdown的段落、清單或是標題裡任意使用。依照個人習慣,甚至可以不用Markdown格式,而採用HTML標籤來格式化。舉例說明:如果比較喜歡HTML的 <code>&lt;a&gt;</code><code>&lt;img&gt;</code>標籤,可以直接使用這些標籤,而不用Markdown提供的連結或是影像標示語法。</p>
<p>HTML區段標籤和區塊標籤不同,在區段標籤的範圍內,Markdown的語法是有效的。</p>
<h3 id="autoescape">特殊字元自動轉換</h3>
<p>在HTML文件中,有兩個字元需要特殊處理:<code>&lt;</code><code>&amp;</code><code>&lt;</code>符號用於起始標籤<code>&amp;</code>符號則用於標記HTML實體,如果你只是想要使用這些符號,你必須要使用實體的形式,像是<code>&amp;lt;</code><code>&amp;amp;</code></p>
<p>在HTML文件中,有兩個字元需要特殊處理:<code>&lt;</code><code>&amp;</code><code>&lt;</code>符號用於起始標籤<code>&amp;</code>符號則用於標記HTML實體,如果你只是想要使用這些符號,你必須要使用實體的形式,像是<code>&amp;lt;</code><code>&amp;amp;</code></p>
<p><code>&amp;</code>符號其實很讓寫作網路文件的人感到困擾,如果你要打「AT&amp;T」,你必須要寫成「<code>AT&amp;amp;T</code>」,還得轉換網址內的<code>&amp;</code>符號,如果你要連結到:</p>
<p><code>&amp;</code> 符號其實很容易讓寫作網路文件的人感到困擾,如果你要打「AT&amp;T」 ,你必須要寫成「<code>AT&amp;amp;T</code> ,還得轉換網址內的 <code>&amp;</code> 符號,如果你要連結到:</p>
<pre><code>http://images.google.com/images?num=30&amp;q=larry+bird
</code></pre>
@ -113,7 +113,7 @@ This is another regular paragraph. @@ -113,7 +113,7 @@ This is another regular paragraph.
<pre><code>AT&amp;amp;T
</code></pre>
<p>類似的狀況也會發生在<code>&lt;</code>符號上,因為Markdown支援<a href="#html">行內HTML</a>,如果你是使用<code>&lt;</code>符號作為HTML標籤使用,那Markdown也不會對它做任何轉換,但是如果你是寫:</p>
<p>類似的狀況也會發生在<code>&lt;</code>符號上,因為Markdown支援<a href="#html">行內 HTML</a> ,如果你是使用<code>&lt;</code>符號作為HTML標籤使用,那Markdown也不會對它做任何轉換,但是如果你是寫:</p>
<pre><code>4 &lt; 5
</code></pre>
@ -123,7 +123,7 @@ This is another regular paragraph. @@ -123,7 +123,7 @@ This is another regular paragraph.
<pre><code>4 &amp;lt; 5
</code></pre>
<p>不過需要注意的是,code範圍內,不論是行內還是區塊,<code>&lt;</code><code>&amp;</code>兩個符號都<em>一定</em>會被轉換成HTML實體,這項特性讓你可以很容易地用Markdown寫HTML code(和HTML相對而言HTML語法中,你要把所有的<code>&lt;</code><code>&amp;</code>都轉換為HTML實體,才能在HTML文件裡面寫出HTML code。)</p>
<p>不過需要注意的是,code範圍內,不論是行內還是區塊,<code>&lt;</code><code>&amp;</code>兩個符號都<em>一定</em>會被轉換成HTML實體,這項特性讓你可以很容易地用Markdown寫HTML code(和HTML相對而言。在HTML語法中,你要把所有的<code>&lt;</code><code>&amp;</code>都轉換為 HTML實體,才能在HTML文件裡面寫出HTML code。)</p>
<hr />
@ -137,7 +137,7 @@ This is another regular paragraph. @@ -137,7 +137,7 @@ This is another regular paragraph.
<p>如果你<em>真的</em>想要插入<code>&lt;br /&gt;</code>標籤的話,在行尾加上兩個以上的空白,然後按enter。</p>
<p>是的,這確實需要花比較多功夫來插入<code>&lt;br /&gt;</code>,但是「每個換行都轉換為<code>&lt;br /&gt;</code>」的方法在 Markdown中並不適合,Markdown中email式的<a href="#blockquote">區塊引言</a>和多段落的<a href="#list">清單</a>在使用換行來排版的時候,不但更好用,還更好閱讀。</p>
<p>是的,這確實需要花比較多功夫來插入<code>&lt;br /&gt;</code>,但是「每個換行都轉換為<code>&lt;br /&gt;</code>」的方法在Markdown中並不適合, Markdown中email式的<a href="#blockquote">區塊引言</a>和多段落的<a href="#list">清單</a>在使用換行來排版的時候,不但更好用,還更好閱讀。</p>
<h3 id="header">標題</h3>
@ -154,7 +154,7 @@ This is an H2 @@ -154,7 +154,7 @@ This is an H2
<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
@ -172,7 +172,7 @@ This is an H2 @@ -172,7 +172,7 @@ This is an H2
### This is an H3 ######
</code></pre>
<h3 id="blockquote">Blockquotes</h3>
<h3 id="blockquote">區塊引言</h3>
<p>Markdown使用email形式的區塊引言,如果你很熟悉如何在email信件中引言,你就知道怎麼在Markdown文件中建立一個區塊引言,那會看起來像是你強迫斷行,然後在每行的最前面加上<code>&gt;</code></p>
@ -296,7 +296,7 @@ viverra nec, fringilla in, laoreet vitae, risus. @@ -296,7 +296,7 @@ viverra nec, fringilla in, laoreet vitae, risus.
Suspendisse id sem consectetuer libero luctus adipiscing.
</code></pre>
<p>如果清單項目間用空行分開,Markdown會把項目的內容在輸出時用<code>&lt;p&gt;</code>標籤包起來,舉例來說:</p>
<p>如果清單項目間用空行分開, Markdown會把項目的內容在輸出時用<code>&lt;p&gt;</code>標籤包起來,舉例來說:</p>
<pre><code>* Bird
* Magic
@ -325,7 +325,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing. @@ -325,7 +325,7 @@ Suspendisse id sem consectetuer libero luctus adipiscing.
&lt;/ul&gt;
</code></pre>
<p>清單項目可以包含多個段落,每個項目下的段落都必須縮排4個空白或是一個tab </p>
<p>清單項目可以包含多個段落,每個項目下的段落都必須縮排4個空白或是一個tab:</p>
<pre><code>1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
@ -393,7 +393,7 @@ sit amet, consectetuer adipiscing elit. @@ -393,7 +393,7 @@ sit amet, consectetuer adipiscing elit.
&lt;/code&gt;&lt;/pre&gt;
</code></pre>
<p>這個每行一階的縮排(4個空白或是tab),都會被移除,例如:</p>
<p>這個每行一階的縮排(4個空白或是1個tab),都會被移除,例如:</p>
<pre><code>Here is an example of AppleScript:
@ -414,7 +414,7 @@ end tell @@ -414,7 +414,7 @@ end tell
<p>一個程式碼區塊會一直持續到沒有縮排的那一行(或是文件結尾)。</p>
<p>在程式碼區塊裡面,<code>&amp;</code><code>&lt;</code><code>&gt;</code>會自動轉成HTML實體,這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼,只需要複製貼上,再加上縮排就可以了,剩下的 Markdown都會幫你處理,例如:</p>
<p>在程式碼區塊裡面,<code>&amp;</code><code>&lt;</code><code>&gt;</code>會自動轉成HTML實體,這樣的方式讓你非常容易使用Markdown插入範例用的HTML原始碼,只需要複製貼上,再加上縮排就可以了,剩下的Markdown都會幫你處理,例如:</p>
<pre><code> &lt;div class="footer"&gt;
&amp;copy; 2004 Foo Corporation
@ -452,9 +452,9 @@ end tell @@ -452,9 +452,9 @@ end tell
<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>
@ -497,9 +497,9 @@ title attribute.&lt;/p&gt; @@ -497,9 +497,9 @@ title attribute.&lt;/p&gt;
<ul>
<li>方括號,裡面輸入連結的辨識用標籤</li>
<li>接著一個冒號</li>
<li>接著一個以上的空白或 tab</li>
<li>接著一個以上的空白或tab</li>
<li>接著連結的網址</li>
<li>選擇性地接著 title 內容,可以用單引號、雙引號或是括弧包著</li>
<li>選擇性地接著title內容,可以用單引號、雙引號或是括弧包著</li>
</ul>
<p>下面這三種連結的定義都是相同:</p>
@ -511,7 +511,7 @@ title attribute.&lt;/p&gt; @@ -511,7 +511,7 @@ title attribute.&lt;/p&gt;
<p><strong>請注意:</strong>有一個已知的問題是Markdown.pl 1.0.1會忽略單引號包起來的連結title。</p>
<p>連結網址也可以用括號包起來:</p>
<p>連結網址也可以用括號包起來:</p>
<pre><code>[id]: &lt;http://example.com/&gt; "Optional Title Here"
</code></pre>
@ -530,7 +530,7 @@ title attribute.&lt;/p&gt; @@ -530,7 +530,7 @@ title attribute.&lt;/p&gt;
[link text][A]
</code></pre>
<p><em>預設的連結標籤</em>功能讓你可以省略指定連結標籤,這種情形下,連結標籤和連結文字會視為相同,要用預設連結標籤只要在連結文字後面加上一個空的方括號,如果你要讓「Google」連結到google.com,你可以簡化成:</p>
<p><em>預設的連結標籤</em>功能讓你可以省略指定連結標籤,這種情形下,連結標籤和連結文字會視為相同,要用預設連結標籤只要在連結文字後面加上一個空的方括號,如果你要讓"Google"連結到google.com,你可以簡化成:</p>
<pre><code>[Google][]
</code></pre>
@ -587,7 +587,7 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or @@ -587,7 +587,7 @@ than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
</code></pre>
<p>參考式的連結其實重點不在於它比較好寫,而是它比較好讀,比較一下上面的範例,使用參考式的文章本身只有 81 個字元,但是用行內形式的連結卻會增加到176個字元,如果是用純HTML格式來寫,會有234個字元,在HTML格式中,標籤比文字還要多。</p>
<p>參考式的連結其實重點不在於它比較好寫,而是它比較好讀,比較一下上面的範例,使用參考式的文章本身只有81個字元,但是用行內形式的連結卻會增加到176個字元,如果是用純HTML格式來寫,會有234個字元,在HTML格式中,標籤比文字還要多。</p>
<p>使用Markdown的參考式連結,可以讓文件更像是瀏覽器最後產生的結果,讓你可以把一些標記相關的資訊移到段落文字之外,你就可以增加連結而不讓文章的閱讀感覺被打斷。</p>
@ -622,7 +622,7 @@ __double underscores__ @@ -622,7 +622,7 @@ __double underscores__
<pre><code>un*frigging*believable
</code></pre>
<p>但是如果你的<code>*</code><code>_</code>兩邊都有空白的話,它們就只會被當成普通的符號。</p>
<p>但是如果你的 <code>*</code> <code>_</code> 兩邊都有空白的話,它們就只會被當成普通的符號。</p>
<p>如果要在文字前後直接插入普通的星號或底線,你可以用反斜線:</p>
@ -665,7 +665,7 @@ A backtick-delimited string in a code span: `` `foo` `` @@ -665,7 +665,7 @@ A backtick-delimited string in a code span: `` `foo` ``
&lt;p&gt;A backtick-delimited string in a code span: &lt;code&gt;`foo`&lt;/code&gt;&lt;/p&gt;
</code></pre>
<p>在程式碼區段內,<code>&amp;</code>括號都會被轉成HTML實體,這樣會比較容易插入HTML原始碼,Markdown會把下面這段:</p>
<p>在程式碼區段內,<code>&amp;</code>括號都會被轉成HTML實體,這樣會比較容易插入HTML原始碼,Markdown會把下面這段:</p>
<pre><code>Please don't use any `&lt;blink&gt;` tags.
</code></pre>
@ -690,7 +690,7 @@ equivalent of &lt;code&gt;&amp;amp;mdash;&lt;/code&gt;.&lt;/p&gt; @@ -690,7 +690,7 @@ equivalent of &lt;code&gt;&amp;amp;mdash;&lt;/code&gt;.&lt;/p&gt;
<p>很明顯地,要在純文字應用中設計一個「自然」的語法來插入圖片是有一定難度的。</p>
<p>Markdown使用一種和連結很相似的語法來標記圖片,同樣也允許兩種樣式: <em>行內</em><em>參考</em></p>
<p>Markdown使用一種和連結很相似的語法來標記圖片,同樣也允許兩種樣式:<em>行內</em><em>參考</em></p>
<p>行內圖片的語法看起來像是:</p>
@ -702,10 +702,10 @@ equivalent of &lt;code&gt;&amp;amp;mdash;&lt;/code&gt;.&lt;/p&gt; @@ -702,10 +702,10 @@ equivalent of &lt;code&gt;&amp;amp;mdash;&lt;/code&gt;.&lt;/p&gt;
<p>詳細敘述如下:</p>
<ul>
<li>一個驚嘆號 <code>!</code></li>
<li>一個驚嘆號<code>!</code></li>
<li>接著一個方括號,裡面放上圖片的替代文字</li>
<li>接著一個普通括號,裡面放上圖片的網址,最後還可以用引號包住並加上
選擇性的 'title' 文字。</li>
選擇性的'title'文字。</li>
</ul>
<p>參考式的圖片語法則長得像這樣:</p>
@ -726,7 +726,7 @@ equivalent of &lt;code&gt;&amp;amp;mdash;&lt;/code&gt;.&lt;/p&gt; @@ -726,7 +726,7 @@ equivalent of &lt;code&gt;&amp;amp;mdash;&lt;/code&gt;.&lt;/p&gt;
<h3 id="autolink">自動連結</h3>
<p>Markdown支援比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用括號包起來,Markdown就會自動把它轉成連結,連結的文字就和連結位置一樣,例如:</p>
<p>Markdown支援比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用括號包起來,Markdown就會自動把它轉成連結,連結的文字就和連結位置一樣,例如:</p>
<pre><code>&lt;http://example.com/&gt;
</code></pre>
@ -778,4 +778,4 @@ _ 底線 @@ -778,4 +778,4 @@ _ 底線
<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>

1
external-link-alt-solid.svg

@ -0,0 +1 @@ @@ -0,0 +1 @@
<svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="external-link-alt" class="svg-inline--fa fa-external-link-alt fa-w-16" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="#666" d="M432,320H400a16,16,0,0,0-16,16V448H64V128H208a16,16,0,0,0,16-16V80a16,16,0,0,0-16-16H48A48,48,0,0,0,0,112V464a48,48,0,0,0,48,48H400a48,48,0,0,0,48-48V336A16,16,0,0,0,432,320ZM488,0h-128c-21.37,0-32.05,25.91-17,41l35.73,35.73L135,320.37a24,24,0,0,0,0,34L157.67,377a24,24,0,0,0,34,0L435.28,133.32,471,169c15,15,41,4.5,41-17V24A24,24,0,0,0,488,0Z"></path></svg>

After

Width:  |  Height:  |  Size: 589 B

42
footer.html

@ -1,42 +0,0 @@ @@ -1,42 +0,0 @@
</div>
<div id="comments">
<div id="disqus_thread"></div>
<script type="text/javascript">
/* * * CONFIGURATION VARIABLES: EDIT BEFORE PASTING INTO YOUR WEBPAGE * * */
var disqus_shortname = 'markdowntw'; // required: replace example with your forum shortname
// The following are highly recommended additional parameters. Remove the slashes in front to use.
// var disqus_identifier = 'unique_dynamic_id_1234';
// var disqus_url = 'http://example.com/permalink-to-page.html';
/* * * DON'T EDIT BELOW THIS LINE * * */
(function() {
var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;
dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js';
(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq);
})();
</script>
<noscript>Please enable JavaScript to view the <a href="http://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
</div>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-21880461-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
<script src="/js/jquery-2.0.3.min.js"></script>
<script src="js/han.js"></script>
</body>
</html>

20
general_footer.html

@ -1,20 +0,0 @@ @@ -1,20 +0,0 @@
</div>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-21880461-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
<script src="/js/jquery-2.0.3.min.js"></script>
<script src="js/han.js"></script>
</body>
</html>

23
header.html

@ -1,23 +0,0 @@ @@ -1,23 +0,0 @@
<!DOCTYPE html>
<html lang="zh-TW" class="han-biaodian-pro-cns han-la">
<head>
<meta charset="UTF-8">
<title>Markdown 語法說明</title>
<link rel="stylesheet" media="all" href="stylesheets/han.css">
<link rel="stylesheet" media="all" href="stylesheets/main.css">
<meta property="og:title" content="Markdown 語法說明" />
<meta property="og:url" content="http://markdown.tw/" />
<meta property="og:type" content="website" />
<meta property="og:description" content="Markdown 是很簡單的純文件格式,由於語法設計得好,近幾年廣泛應用在各種領域,包括 Github、Stack Overflow 等知名的網路服務都使用它,本網頁為該語法的中文說明" />
<meta property="og:image" content="http://markdown.tw/images/208x128.png" />
<meta property="og:image:width" content="208" />
<meta property="og:image:height" content="128" />
</head>
<body>
<nav>
<a href="/">文件</a>
<a href="/resources.html">資源</a>
<a href="https://github.com/othree/markdown-syntax-zhtw/issues">回報錯誤</a>
</nav>
<div class="wikistyle">

819
index.html

File diff suppressed because it is too large Load Diff

1225
js/han.js

File diff suppressed because it is too large Load Diff

6
js/jquery-2.0.3.min.js vendored

File diff suppressed because one or more lines are too long

262
resources.html

@ -1,57 +1,91 @@ @@ -1,57 +1,91 @@
<!DOCTYPE html>
<html lang="zh-TW" class="han-biaodian-pro-cns han-la">
<head>
<meta charset="UTF-8">
<title>Markdown 語法說明</title>
<link rel="stylesheet" media="all" href="stylesheets/han.css">
<link rel="stylesheet" media="all" href="stylesheets/main.css">
<meta property="og:title" content="Markdown 語法說明" />
<meta property="og:url" content="http://markdown.tw/" />
<meta property="og:type" content="website" />
<meta property="og:description" content="Markdown 是很簡單的純文件格式,由於語法設計得好,近幾年廣泛應用在各種領域,包括 Github、Stack Overflow 等知名的網路服務都使用它,本網頁為該語法的中文說明" />
<meta property="og:image" content="http://markdown.tw/images/208x128.png" />
<meta property="og:image:width" content="208" />
<meta property="og:image:height" content="128" />
</head>
<body>
<nav>
<a href="/">文件</a>
<a href="/resources.html">資源</a>
<a href="https://github.com/othree/markdown-syntax-zhtw/issues">回報錯誤</a>
</nav>
<div class="wikistyle">
<h1>Markdown資源</h1>
<p><img src="http://markdown.tw/images/208x128.png" alt="Markdown" title="" /></p>
<h2>Logo</h2>
<head>
<meta charset="UTF-8" />
<title>Markdown 語法說明</title>
<link
rel="stylesheet"
media="all"
href="//cdnjs.cloudflare.com/ajax/libs/Han/3.2.2/han.min.css"
/>
<link rel="stylesheet" media="all" href="stylesheets/main.css" />
<meta property="og:title" content="Markdown 語法說明" />
<meta property="og:url" content="https://markdown.tw/" />
<meta property="og:type" content="website" />
<meta
property="og:description"
content="Markdown 是很簡單的純文件格式,由於語法設計得好,近幾年廣泛應用在各種領域,包括 Github、Stack Overflow 等知名的網路服務都使用它,本網頁為該語法的中文說明"
/>
<meta
property="og:image"
content="https://markdown.tw/images/208x128.png"
/>
<meta property="og:image:width" content="208" />
<meta property="og:image:height" content="128" />
</head>
<body
class="tk-source-han-sans-traditional"
style="font-family: -apple-system;"
>
<nav>
<a href="/">文件</a>
<a href="/resources.html">資源</a>
<a href="http://commonmark.org/"
>標準<img
src="external-link-alt-solid.svg"
width="12"
height="12"
alt=""
style="margin: 1px 0 -1px 3px;"
/></a>
<a href="https://github.com/othree/markdown-syntax-zhtw/issues"
>回報錯誤<img
src="external-link-alt-solid.svg"
width="12"
height="12"
alt=""
style="margin: 1px 0 -1px 3px;"
/></a>
</nav>
<div class="wikistyle">
<h1 id="markdown-資源">Markdown 資源</h1>
<p><img src="https://markdown.tw/images/208x128.png" /></p>
<h2 id="spec">Spec</h2>
<ul>
<li><a href="http://commonmark.org/">CommonMark</a></li>
</ul>
<h2 id="logo">Logo</h2>
<ul>
<li><a href="http://dcurt.is/the-markdown-mark">The Markdown Mark</a></li>
</ul>
<h2>編輯器</h2>
<h3>寫作用編輯器</h3>
<h2 id="社群">社群</h2>
<ul>
<li><a href="https://www.facebook.com/groups/830853873715381/">Facebook Markdown 台灣 Group</a></li>
</ul>
<h2 id="編輯器">編輯器</h2>
<h3 id="寫作用編輯器">寫作用編輯器</h3>
<ul>
<li>OSX
<ul>
<li><a href="http://typora.io/">Typora</a></li>
<li><a href="http://macdown.uranusjr.com/">MacDown</a></li>
<li><a href="http://bywordapp.com/">Byword</a></li>
<li><a href="http://www.iawriter.com/mac/">iA Writer</a></li>
<li><a href="http://mouapp.com/">Mouapp</a></li>
<li><a href="http://www.texts.io/">TEXTS</a></li>
<li><a href="http://kobito.qiita.com/">Kobito</a></li>
</ul></li>
<li>Linux
<ul>
<li><a href="http://sourceforge.net/p/retext/home/ReText/">ReText</a></li>
<li><a href="http://uberwriter.wolfvollprecht.de/">UberWriter</a></li>
</ul></li>
<li>Windows
<ul>
<li><a href="http://markdownpad.com/">MarkdownPad</a></li>
<li><a href="http://www.texts.io/">TEXTS</a></li>
<li><a href="https://miu.0x142857.com">Miu</a></li>
</ul></li>
<li>iOS
<ul>
@ -59,19 +93,19 @@ @@ -59,19 +93,19 @@
<li><a href="http://www.iawriter.com/ipad/">iA Writer for iPad</a></li>
<li><a href="http://www.iawriter.com/iphone/">iA Writer for iPhone</a></li>
</ul></li>
<li>All
<ul>
<li><a href="https://yhatt.github.io/marp/">Marp</a>, Markdown to slide</li>
</ul></li>
</ul>
<h3>預覽</h3>
<h3 id="預覽">預覽</h3>
<ul>
<li>OSX
<ul>
<li><a href="https://itunes.apple.com/us/app/marked/id448925439">Marked</a></li>
</ul></li>
</ul>
<h3>通用文字編輯器</h3>
<h3 id="通用文字編輯器">通用文字編輯器</h3>
<ul>
<li><a href="http://www.sublimetext.com/">Sublime Text</a></li>
<li>Vim
@ -80,9 +114,7 @@ @@ -80,9 +114,7 @@
<li><a href="https://github.com/tpope/vim-markdown">tpope/vim-markdown</a></li>
</ul></li>
</ul>
<h3>網頁文字編輯器</h3>
<h3 id="網頁文字編輯器">網頁文字編輯器</h3>
<ul>
<li><a href="http://ace.ajax.org/">Ace</a></li>
<li><a href="http://codemirror.net/">CodeMirror</a></li>
@ -90,101 +122,147 @@ @@ -90,101 +122,147 @@
<li><a href="http://oscargodson.github.io/EpicEditor/">EpicEditor</a></li>
<li><a href="https://github.com/bianchimro/markgiu">Markgiu</a></li>
</ul>
<h2>擴充版Markdown</h2>
<h3 id="瀏覽器-extension">瀏覽器 Extension</h3>
<ul>
<li><a href="https://github.com/adam-p/markdown-here/">Markdown Here</a></li>
</ul>
<h2 id="變形版-markdown">變形版 Markdown</h2>
<ul>
<li><a href="https://help.github.com/articles/github-flavored-markdown">GitHub Flavored Markdown</a></li>
<li><a href="https://help.github.com/articles/github-flavored-markdown">GitHub Flavored Markdown</a>
<ul>
<li><a href="https://github.github.com/gfm/">Spec</a></li>
<li><a href="https://github.com/github/cmark-gfm">Source</a></li>
</ul></li>
<li><a href="https://gitlab.com/help/user/markdown">GitLab Flavored Markdown</a></li>
<li><a href="http://kramdown.rubyforge.org/quickref.html#headers">kramdown</a></li>
<li><a href="http://fletcherpenney.net/multimarkdown/">MultiMarkdown</a></li>
<li><a href="http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown">Pandoc's markdown</a>
<li><a href="http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown">Pandocs markdown</a>
<ul>
<li><a href="http://pages.tzengyuxio.me/pandoc/">Pandoc’s Markdown 語法中文翻譯</a> </li>
<li><a href="http://pages.tzengyuxio.me/pandoc/">Pandoc’s Markdown 語法中文翻譯</a></li>
</ul></li>
<li><a href="http://michelf.ca/projects/php-markdown/extra/">PHP Markdown Extra</a></li>
<li><a href="https://rmarkdown.rstudio.com/">R Markdown</a></li>
<li><a href="http://markua.com/">Maruka</a></li>
<li><a href="https://apiblueprint.org/">API Blueprint</a></li>
<li><a href="https://apiblueprint.org/documentation/mson/tutorial.html">MSON</a></li>
<li><a href="https://www.reddit.com/wiki/markdown">Reddit-flavored Markdown</a>
<ul>
<li><a href="https://github.com/zeantsoi/snoomark-binding">Binding</a></li>
</ul></li>
</ul>
<h2>引擎</h2>
<h2 id="引擎">引擎</h2>
<ul>
<li>C
<ul>
<li><a href="https://github.com/vmg/sundown">Sundown</a> </li>
<li><a href="https://github.com/jgm/cmark">cmark</a></li>
<li><a href="https://github.com/github/cmark-gfm">cmark-gfm</a></li>
<li><a href="https://github.com/vmg/sundown">Sundown</a></li>
</ul></li>
<li>JavaScript
<ul>
<li><a href="https://github.com/jgm/commonmark.js">commonmark.js</a></li>
<li><a href="https://github.com/cky/wmd">showdown</a>, not maintained any more</li>
<li><a href="https://code.google.com/p/pagedown/">pagedown</a>, StackOverflow</li>
<li><a href="https://github.com/StackExchange/pagedown">pagedown</a>, StackOverflow</li>
<li><a href="https://github.com/coreyti/showdown">coreyti/showdown</a></li>
<li><a href="https://github.com/chjj/marked">marked</a></li>
<li><a href="https://jonschlinkert.github.io/remarkable/demo/">Remarkable</a></li>
</ul></li>
<li>PHP
<ul>
<li><a href="http://michelf.ca/projects/php-markdown/">PHP Markdown</a></li>
</ul></li>
<li>Python
<ul>
<li><a href="https://pypi.python.org/pypi/CommonMark">CommonMark</a></li>
</ul></li>
<li>Ruby
<ul>
<li><a href="https://github.com/vmg/redcarpet">Redcarpet</a> </li>
<li><a href="https://github.com/vmg/redcarpet">Redcarpet</a></li>
<li><a href="https://github.com/bhollis/maruku">Maruku</a></li>
</ul></li>
<li>Rust
<ul>
<li><a href="https://github.com/kivikakk/comrak">comark</a></li>
<li><a href="https://github.com/raphlinus/pulldown-cmark">pulldown-cmark</a></li>
</ul></li>
</ul>
<h2>Blog服務</h2>
<h2 id="反向引擎">反向引擎</h2>
<ul>
<li><a href="https://leeoniya.github.io/reMarked.js/">reMarked.js</a></li>
</ul>
<h2 id="其它用途引擎">其它用途引擎</h2>
<ul>
<li><a href="https://anydown.github.io/maildown/">maildown</a>, 轉為日本常用商業郵件格式</li>
<li><a href="https://conv.denshochan.com/tw/markdown">電電 Markdown</a>,擴充語法,轉為電子書,非開源</li>
<li><a href="https://github.com/mdx-js/mdx">mdx</a> Markdown in JSX</li>
<li><a href="https://github.com/jxnblk/mdx-deck">mdx-deck</a> MDX-based presentation decks</li>
<li><a href="https://github.com/jamesknelson/mdxc">mdxc</a> Convert markdown to React Component</li>
</ul>
<h2 id="blog-服務">Blog 服務</h2>
<ul>
<li><a href="http://wordpress.com/">WordPress.com</a></li>
<li><a href="http://logdown.com/">logdown</a></li>
</ul>
<h2>Blog 系統</h2>
<h2 id="blog-系統">Blog 系統</h2>
<ul>
<li><a href="http://wordpress.org/">WordPress</a></li>
<li><a href="http://www.movabletype.org/">MOVABLETYPE</a></li>
</ul>
<h2>CSS</h2>
<h2 id="其它服務">其它服務</h2>
<ul>
<li><a href="https://hackmd.io/">HackMD</a></li>
</ul>
<h2 id="css">CSS</h2>
<ul>
<li><a href="http://jasonm23.github.io/markdown-css-themes/">Markdown css themes</a></li>
<li><a href="http://mrcoles.com/demo/markdown-css/">Markdown.css</a></li>
</ul>
<h2>其他工具</h2>
<h2 id="其他工具">其他工具</h2>
<ul>
<li><a href="http://www.stack.nl/~dimitri/doxygen/manual/markdown.html">Doxygen</a></li>
</ul>
<h2>標準</h2>
<h2 id="標準">標準</h2>
<ul>
<li><a href="http://daringfireball.net/projects/markdown/">Markdown</a></li>
<li><a href="http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html">The Future of Markdown</a></li>
<li><a href="http://www.w3.org/community/markdown/">W3C Markdown Community Group</a></li>
<li><a href="http://www.w3.org/community/markdown/wiki/Main_Page">W3C Markdown Community Group wiki</a></li>
</ul>
<h2>感謝</h2>
<p>感謝<a href="http://kidwm.net/">WM</a>協助整理</p>
</div>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-21880461-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
<script src="/js/jquery-2.0.3.min.js"></script>
<script src="js/han.js"></script>
</body>
<h2 id="文章">文章</h2>
<ul>
<li><a href="https://blog.codinghorror.com/standard-flavored-markdown/">Standard Flavored Markdown</a> - 標準化緣起</li>
</ul>
<h2 id="感謝">感謝</h2>
<p>感謝 <a href="http://kidwm.net/">WM</a> 協助整理</p>
</div>
<footer>Made with &lt;3 by <a href="https://othree.net">othree</a>.</footer>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(["_setAccount", "UA-21880461-1"]);
_gaq.push(["_trackPageview"]);
(function () {
var ga = document.createElement("script");
ga.type = "text/javascript";
ga.async = true;
ga.src =
("https:" == document.location.protocol
? "https://ssl"
: "http://www") + ".google-analytics.com/ga.js";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(ga, s);
})();
</script>
<script src="https://use.typekit.net/gib3xul.js"></script>
<script>
try {
Typekit.load();
} catch (e) {}
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/Han/3.2.2/han.min.js"></script>
</body>
</html>

149
resources.md

@ -1,101 +1,158 @@ @@ -1,101 +1,158 @@
Markdown 資源
==================
![Markdown](http://markdown.tw/images/208x128.png)
# Markdown 資源
Logo
----
![](https://markdown.tw/images/208x128.png)
## Spec
* [CommonMark](http://commonmark.org/)
## Logo
* [The Markdown Mark](http://dcurt.is/the-markdown-mark)
編輯器
-----
## 社群
* [Facebook Markdown 台灣 Group](https://www.facebook.com/groups/830853873715381/)
## 編輯器
### 寫作用編輯器
* OSX
* [Byword](http://bywordapp.com/)
* [iA Writer](http://www.iawriter.com/mac/)
* [Mouapp](http://mouapp.com/)
* [TEXTS](http://www.texts.io/)
* [Typora](http://typora.io/)
* [MacDown](http://macdown.uranusjr.com/)
* [Byword](http://bywordapp.com/)
* [iA Writer](http://www.iawriter.com/mac/)
* [Mouapp](http://mouapp.com/)
* [TEXTS](http://www.texts.io/)
* [Kobito](http://kobito.qiita.com/)
* Linux
* [ReText](http://sourceforge.net/p/retext/home/ReText/)
* [ReText](http://sourceforge.net/p/retext/home/ReText/)
* [UberWriter](http://uberwriter.wolfvollprecht.de/)
* Windows
* [MarkdownPad](http://markdownpad.com/)
* [TEXTS](http://www.texts.io/)
* [MarkdownPad](http://markdownpad.com/)
* [TEXTS](http://www.texts.io/)
* [Miu](https://miu.0x142857.com)
* iOS
* [Byword](http://bywordapp.com/)
* [iA Writer for iPad](http://www.iawriter.com/ipad/)
* [iA Writer for iPhone](http://www.iawriter.com/iphone/)
* [Byword](http://bywordapp.com/)
* [iA Writer for iPad](http://www.iawriter.com/ipad/)
* [iA Writer for iPhone](http://www.iawriter.com/iphone/)
* All
* [Marp](https://yhatt.github.io/marp/), Markdown to slide
### 預覽
* OSX
* [Marked](https://itunes.apple.com/us/app/marked/id448925439)
* [Marked](https://itunes.apple.com/us/app/marked/id448925439)
### 通用文字編輯器
### 通用文字編輯器
* [Sublime Text](http://www.sublimetext.com/)
* Vim
* [plasticboy/vim-markdown](https://github.com/plasticboy/vim-markdown)
* [tpope/vim-markdown](https://github.com/tpope/vim-markdown)
* [plasticboy/vim-markdown](https://github.com/plasticboy/vim-markdown)
* [tpope/vim-markdown](https://github.com/tpope/vim-markdown)
### 網頁文字編輯器
* [Ace](http://ace.ajax.org/)
* [CodeMirror](http://codemirror.net/)
* [Dillinger](http://dillinger.io/)
* [EpicEditor](http://oscargodson.github.io/EpicEditor/)
* [Markgiu](https://github.com/bianchimro/markgiu)
擴充版 Markdown
--------------
### 瀏覽器 Extension
* [Markdown Here](https://github.com/adam-p/markdown-here/)
## 變形版 Markdown
* [GitHub Flavored Markdown](https://help.github.com/articles/github-flavored-markdown)
* [Spec](https://github.github.com/gfm/)
* [Source](https://github.com/github/cmark-gfm)
* [GitLab Flavored Markdown](https://gitlab.com/help/user/markdown)
* [kramdown](http://kramdown.rubyforge.org/quickref.html#headers)
* [MultiMarkdown](http://fletcherpenney.net/multimarkdown/)
* [Pandoc's markdown](http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown)
* [Pandoc’s Markdown 語法中文翻譯](http://pages.tzengyuxio.me/pandoc/)
* [Pandoc’s Markdown 語法中文翻譯](http://pages.tzengyuxio.me/pandoc/)
* [PHP Markdown Extra](http://michelf.ca/projects/php-markdown/extra/)
* [R Markdown](https://rmarkdown.rstudio.com/)
* [Maruka](http://markua.com/)
* [API Blueprint](https://apiblueprint.org/)
* [MSON](https://apiblueprint.org/documentation/mson/tutorial.html)
* [Reddit-flavored Markdown](https://www.reddit.com/wiki/markdown)
* [Binding](https://github.com/zeantsoi/snoomark-binding)
## 引擎
引擎
----
* C
* [Sundown](https://github.com/vmg/sundown)
* [cmark](https://github.com/jgm/cmark)
* [cmark-gfm](https://github.com/github/cmark-gfm)
* [Sundown](https://github.com/vmg/sundown)
* JavaScript
* [showdown](https://github.com/cky/wmd), not maintained any more
* [pagedown](https://code.google.com/p/pagedown/), StackOverflow
* [coreyti/showdown](https://github.com/coreyti/showdown)
* [marked](https://github.com/chjj/marked)
* [commonmark.js](https://github.com/jgm/commonmark.js)
* [showdown](https://github.com/cky/wmd), not maintained any more
* [pagedown](https://github.com/StackExchange/pagedown), StackOverflow
* [coreyti/showdown](https://github.com/coreyti/showdown)
* [marked](https://github.com/chjj/marked)
* [Remarkable](https://jonschlinkert.github.io/remarkable/demo/)
* PHP
* [PHP Markdown](http://michelf.ca/projects/php-markdown/)
* [PHP Markdown](http://michelf.ca/projects/php-markdown/)
* Python
* [CommonMark](https://pypi.python.org/pypi/CommonMark)
* Ruby
* [Redcarpet](https://github.com/vmg/redcarpet)
* [Maruku](https://github.com/bhollis/maruku)
* [Redcarpet](https://github.com/vmg/redcarpet)
* [Maruku](https://github.com/bhollis/maruku)
* Rust
* [comark](https://github.com/kivikakk/comrak)
* [pulldown-cmark](https://github.com/raphlinus/pulldown-cmark)
## 反向引擎
* [reMarked.js](https://leeoniya.github.io/reMarked.js/)
Blog 服務
---------
## 其它用途引擎
* [maildown](https://anydown.github.io/maildown/), 轉為日本常用商業郵件格式
* [電電 Markdown](https://conv.denshochan.com/tw/markdown),擴充語法,轉為電子書,非開源
* [mdx](https://github.com/mdx-js/mdx) Markdown in JSX
* [mdx-deck](https://github.com/jxnblk/mdx-deck) MDX-based presentation decks
* [mdxc](https://github.com/jamesknelson/mdxc) Convert markdown to React Component
## Blog 服務
* [WordPress.com](http://wordpress.com/)
* [logdown](http://logdown.com/)
Blog 系統
---------
## Blog 系統
* [WordPress](http://wordpress.org/)
* [MOVABLETYPE](http://www.movabletype.org/)
CSS
---
## 其它服務
* [HackMD](https://hackmd.io/)
## CSS
* [Markdown css themes](http://jasonm23.github.io/markdown-css-themes/)
* [Markdown.css](http://mrcoles.com/demo/markdown-css/)
其他工具
--------
## 其他工具
* [Doxygen](http://www.stack.nl/~dimitri/doxygen/manual/markdown.html)
標準
----
## 標準
* [Markdown](http://daringfireball.net/projects/markdown/)
* [The Future of Markdown](http://www.codinghorror.com/blog/2012/10/the-future-of-markdown.html)
* [W3C Markdown Community Group](http://www.w3.org/community/markdown/)
* [W3C Markdown Community Group wiki](http://www.w3.org/community/markdown/wiki/Main_Page)
## 文章
* [Standard Flavored Markdown](https://blog.codinghorror.com/standard-flavored-markdown/) - 標準化緣起
感謝
----
## 感謝
感謝 [WM](http://kidwm.net/) 協助整理

77
resources_content.html

@ -1,6 +1,12 @@ @@ -1,6 +1,12 @@
<h1>Markdown資源</h1>
<h1>Markdown 資源</h1>
<p><img src="http://markdown.tw/images/208x128.png" alt="Markdown" title="" /></p>
<p><img src="https://markdown.tw/images/208x128.png" alt="Markdown" title="" /></p>
<h2>Spec</h2>
<ul>
<li><a href="http://commonmark.org/">CommonMark</a></li>
</ul>
<h2>Logo</h2>
@ -8,6 +14,12 @@ @@ -8,6 +14,12 @@
<li><a href="http://dcurt.is/the-markdown-mark">The Markdown Mark</a></li>
</ul>
<h2>社群</h2>
<ul>
<li><a href="https://www.facebook.com/groups/830853873715381/">Facebook Markdown 台灣 Group</a></li>
</ul>
<h2>編輯器</h2>
<h3>寫作用編輯器</h3>
@ -15,19 +27,24 @@ @@ -15,19 +27,24 @@
<ul>
<li>OSX
<ul>
<li><a href="http://typora.io/">Typora</a></li>
<li><a href="http://macdown.uranusjr.com/">MacDown</a></li>
<li><a href="http://bywordapp.com/">Byword</a></li>
<li><a href="http://www.iawriter.com/mac/">iA Writer</a></li>
<li><a href="http://mouapp.com/">Mouapp</a></li>
<li><a href="http://www.texts.io/">TEXTS</a></li>
<li><a href="http://kobito.qiita.com/">Kobito</a></li>
</ul></li>
<li>Linux
<ul>
<li><a href="http://sourceforge.net/p/retext/home/ReText/">ReText</a></li>
<li><a href="http://uberwriter.wolfvollprecht.de/">UberWriter</a></li>
</ul></li>
<li>Windows
<ul>
<li><a href="http://markdownpad.com/">MarkdownPad</a></li>
<li><a href="http://www.texts.io/">TEXTS</a></li>
<li><a href="https://miu.0x142857.com">Miu</a></li>
</ul></li>
<li>iOS
<ul>
@ -35,6 +52,10 @@ @@ -35,6 +52,10 @@
<li><a href="http://www.iawriter.com/ipad/">iA Writer for iPad</a></li>
<li><a href="http://www.iawriter.com/iphone/">iA Writer for iPhone</a></li>
</ul></li>
<li>All
<ul>
<li><a href="https://yhatt.github.io/marp/">Marp</a>, Markdown to slide</li>
</ul></li>
</ul>
<h3>預覽</h3>
@ -67,17 +88,28 @@ @@ -67,17 +88,28 @@
<li><a href="https://github.com/bianchimro/markgiu">Markgiu</a></li>
</ul>
<h2>擴充版Markdown</h2>
<h3>瀏覽器 Extension</h3>
<ul>
<li><a href="https://help.github.com/articles/github-flavored-markdown">GitHub Flavored Markdown</a></li>
<li><a href="https://github.com/adam-p/markdown-here/">Markdown Here</a></li>
</ul>
<h2>擴充版 Markdown</h2>
<ul>
<li><a href="https://help.github.com/articles/github-flavored-markdown">GitHub Flavored Markdown</a>
<ul>
<li><a href="https://github.github.com/gfm/">Spec</a></li>
</ul></li>
<li><a href="http://kramdown.rubyforge.org/quickref.html#headers">kramdown</a></li>
<li><a href="http://fletcherpenney.net/multimarkdown/">MultiMarkdown</a></li>
<li><a href="http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown">Pandoc's markdown</a>
<ul>
<li><a href="http://pages.tzengyuxio.me/pandoc/">Pandoc’s Markdown 語法中文翻譯</a> </li>
<li><a href="http://pages.tzengyuxio.me/pandoc/">Pandoc’s Markdown 語法中文翻譯</a></li>
</ul></li>
<li><a href="http://michelf.ca/projects/php-markdown/extra/">PHP Markdown Extra</a></li>
<li><a href="https://rmarkdown.rstudio.com/">R Markdown</a></li>
<li><a href="http://markua.com/">Maruka</a></li>
</ul>
<h2>引擎</h2>
@ -85,19 +117,26 @@ @@ -85,19 +117,26 @@
<ul>
<li>C
<ul>
<li><a href="https://github.com/jgm/cmark">cmark</a></li>
<li><a href="https://github.com/vmg/sundown">Sundown</a> </li>
</ul></li>
<li>JavaScript
<ul>
<li><a href="https://github.com/jgm/commonmark.js">commonmark.js</a></li>
<li><a href="https://github.com/cky/wmd">showdown</a>, not maintained any more</li>
<li><a href="https://code.google.com/p/pagedown/">pagedown</a>, StackOverflow</li>
<li><a href="https://github.com/StackExchange/pagedown">pagedown</a>, StackOverflow</li>
<li><a href="https://github.com/coreyti/showdown">coreyti/showdown</a></li>
<li><a href="https://github.com/chjj/marked">marked</a></li>
<li><a href="https://jonschlinkert.github.io/remarkable/demo/">Remarkable</a></li>
</ul></li>
<li>PHP
<ul>
<li><a href="http://michelf.ca/projects/php-markdown/">PHP Markdown</a></li>
</ul></li>
<li>Python
<ul>
<li><a href="https://pypi.python.org/pypi/CommonMark">CommonMark</a></li>
</ul></li>
<li>Ruby
<ul>
<li><a href="https://github.com/vmg/redcarpet">Redcarpet</a> </li>
@ -105,7 +144,23 @@ @@ -105,7 +144,23 @@
</ul></li>
</ul>
<h2>Blog服務</h2>
<h2>反向引擎</h2>
<ul>
<li><a href="https://leeoniya.github.io/reMarked.js/">reMarked.js</a></li>
</ul>
<h2>其它用途引擎</h2>
<ul>
<li><a href="https://anydown.github.io/maildown/">maildown</a>, 轉為日本常用商業郵件格式</li>
<li><a href="https://conv.denshochan.com/tw/markdown">電電 Markdown</a>,擴充語法,轉為電子書,非開源</li>
<li><a href="https://github.com/mdx-js/mdx">mdx</a> Markdown in JSX</li>
<li><a href="https://github.com/jxnblk/mdx-deck">mdx-deck</a> MDX-based presentation decks</li>
<li><a href="https://github.com/jamesknelson/mdxc">mdxc</a> Convert markdown to React Component</li>
</ul>
<h2>Blog 服務</h2>
<ul>
<li><a href="http://wordpress.com/">WordPress.com</a></li>
@ -119,6 +174,12 @@ @@ -119,6 +174,12 @@
<li><a href="http://www.movabletype.org/">MOVABLETYPE</a></li>
</ul>
<h2>其它服務</h2>
<ul>
<li><a href="https://hackmd.io/">HackMD</a></li>
</ul>
<h2>CSS</h2>
<ul>
@ -143,4 +204,4 @@ @@ -143,4 +204,4 @@
<h2>感謝</h2>
<p>感謝<a href="http://kidwm.net/">WM</a>協助整理</p>
<p>感謝 <a href="http://kidwm.net/">WM</a> 協助整理</p>

26
stylesheets/main.css

@ -1,28 +1,40 @@ @@ -1,28 +1,40 @@
html,
html.han-biaodian-pro-cns {
/* font-family: "Biaodian Pro Sans CNS", "Helvetica Neue", Arial, "Han Heiti", sans-serif; */
/* font-family: "Biaodian Pro Sans CNS", "Helvetica Neue", Arial, "Han Heiti", sans-serif; */
}
body {
padding: 0 1em 1em;
margin: 0;
padding: 0 1em;
}
footer {
margin: 64px auto 0;
border-radius: 4px 4px 0 0;
border: 1px solid #e9e9e9;
max-width: 760px;
padding: 6px 10px;
font-size: 12px;
color: #666;
background: #f8f8f8;
}
div.wikistyle ul li,
div.wikistyle ol li,
article.wikistyle ul li,
article.wikistyle ol li {
line-height: 1.2;
line-height: 1.2;
}
nav, div.wikistyle, article.wikistyle, #comments{
width: 760px;
margin: 0 auto;
width: 760px;
margin: 0 auto;
}
div.wikistyle, article.wikistyle, #comments {
margin-top: 1em;
margin-top: 1em;
}
nav a {
margin-right: 0.5em;
margin-right: 0.5em;
}
nav, div.wikistyle, article.wikistyle, #comments{background-color:#f8f8f8;padding:.7em;}
nav, div.wikistyle, article.wikistyle, #comments{border:1px solid #e9e9e9;}

10
syntax.md

@ -1,7 +1,7 @@ @@ -1,7 +1,7 @@
Markdown文件
==================
![Markdown](http://markdown.tw/images/208x128.png)
![](https://markdown.tw/images/208x128.png)
**NOTE:** This is Traditional Chinese Edition Document of
Markdown Syntax. If you are seeking for English Edition
@ -88,7 +88,7 @@ HTML區段標籤和區塊標籤不同,在區段標籤的範圍內,Markdown @@ -88,7 +88,7 @@ HTML區段標籤和區塊標籤不同,在區段標籤的範圍內,Markdown
在HTML文件中,有兩個字元需要特殊處理:`<`和`&`。`<`符號用於起始標籤`&`符號則用於標記HTML實體,如果你只是想要使用這些符號,你必須要使用實體的形式,像是`&lt;`和`&amp;`。
`&`符號其實很讓寫作網路文件的人感到困擾,如果你要打「AT&T」,你必須要寫成「`AT&amp;T`」,還得轉換網址內的`&`符號,如果你要連結到:
`&` 符號其實很容易讓寫作網路文件的人感到困擾,如果你要打「AT&T」 ,你必須要寫成「`AT&amp;T`」 ,還得轉換網址內的 `&` 符號,如果你要連結到:
http://images.google.com/images?num=30&q=larry+bird
@ -469,7 +469,7 @@ Markdown支援兩種形式的連結語法:*行內*和*參考*兩種形式。 @@ -469,7 +469,7 @@ Markdown支援兩種形式的連結語法:*行內*和*參考*兩種形式。
**請注意:**有一個已知的問題是Markdown.pl 1.0.1會忽略單引號包起來的連結title。
連結網址也可以用括號包起來:
連結網址也可以用括號包起來:
[id]: <http://example.com/> "Optional Title Here"
@ -602,7 +602,7 @@ Markdown使用星號(`*`)和底線(`_`)作為標記強調字詞的符號 @@ -602,7 +602,7 @@ Markdown使用星號(`*`)和底線(`_`)作為標記強調字詞的符號
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
在程式碼區段內,`&`和括號都會被轉成HTML實體,這樣會比較容易插入HTML原始碼,Markdown會把下面這段:
在程式碼區段內,`&`和括號都會被轉成HTML實體,這樣會比較容易插入HTML原始碼,Markdown會把下面這段:
Please don't use any `<blink>` tags.
@ -656,7 +656,7 @@ Markdown使用一種和連結很相似的語法來標記圖片,同樣也允許 @@ -656,7 +656,7 @@ Markdown使用一種和連結很相似的語法來標記圖片,同樣也允許
<h3 id="autolink">自動連結</h3>
Markdown支援比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用括號包起來,Markdown就會自動把它轉成連結,連結的文字就和連結位置一樣,例如:
Markdown支援比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用括號包起來,Markdown就會自動把它轉成連結,連結的文字就和連結位置一樣,例如:
<http://example.com/>

83
template.html

@ -0,0 +1,83 @@ @@ -0,0 +1,83 @@
<!DOCTYPE html>
<html lang="zh-TW" class="han-biaodian-pro-cns han-la">
<head>
<meta charset="UTF-8" />
<title>Markdown 語法說明</title>
<link
rel="stylesheet"
media="all"
href="//cdnjs.cloudflare.com/ajax/libs/Han/3.2.2/han.min.css"
/>
<link rel="stylesheet" media="all" href="stylesheets/main.css" />
<meta property="og:title" content="Markdown 語法說明" />
<meta property="og:url" content="https://markdown.tw/" />
<meta property="og:type" content="website" />
<meta
property="og:description"
content="Markdown 是很簡單的純文件格式,由於語法設計得好,近幾年廣泛應用在各種領域,包括 Github、Stack Overflow 等知名的網路服務都使用它,本網頁為該語法的中文說明"
/>
<meta
property="og:image"
content="https://markdown.tw/images/208x128.png"
/>
<meta property="og:image:width" content="208" />
<meta property="og:image:height" content="128" />
</head>
<body
class="tk-source-han-sans-traditional"
style="font-family: -apple-system;"
>
<nav>
<a href="/">文件</a>
<a href="/resources.html">資源</a>
<a href="http://commonmark.org/"
>標準<img
src="external-link-alt-solid.svg"
width="12"
height="12"
alt=""
style="margin: 1px 0 -1px 3px;"
/></a>
<a href="https://github.com/othree/markdown-syntax-zhtw/issues"
>回報錯誤<img
src="external-link-alt-solid.svg"
width="12"
height="12"
alt=""
style="margin: 1px 0 -1px 3px;"
/></a>
</nav>
<div class="wikistyle">
{{ CONTENT }}
</div>
<footer>Made with &lt;3 by <a href="https://othree.net">othree</a>.</footer>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(["_setAccount", "UA-21880461-1"]);
_gaq.push(["_trackPageview"]);
(function () {
var ga = document.createElement("script");
ga.type = "text/javascript";
ga.async = true;
ga.src =
("https:" == document.location.protocol
? "https://ssl"
: "http://www") + ".google-analytics.com/ga.js";
var s = document.getElementsByTagName("script")[0];
s.parentNode.insertBefore(ga, s);
})();
</script>
<script src="https://use.typekit.net/gib3xul.js"></script>
<script>
try {
Typekit.load();
} catch (e) {}
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/Han/3.2.2/han.min.js"></script>
</body>
</html>
Loading…
Cancel
Save