Markdown[編輯]
維基百科,自由的百科全書(shū)

本條目包含指南或教學(xué)內(nèi)容。(2014年9月5日)
請(qǐng)借由移除或重寫(xiě)指南段落來(lái)改善條目,或在討論頁(yè)提出討論。

本條目包含過(guò)多行話或?qū)I(yè)術(shù)語(yǔ),可能需要簡(jiǎn)化或提出進(jìn)一步解釋。(2014年1月8日)
請(qǐng)?jiān)?a target="_blank" rel="nofollow">討論頁(yè)中發(fā)表對(duì)于本議題的看法,并移除或解釋本條目中的行話。
Markdown
擴(kuò)展名
.md
, .markdown
[1]
統(tǒng)一類(lèi)型標(biāo)識(shí)(UTI)
net.daringfireball.markdown
開(kāi)發(fā)者
John Gruber
最新版本
1.0.1(2004年12月17日,?11年前[4]
)
格式類(lèi)型
標(biāo)記語(yǔ)言
網(wǎng)站
daringfireball.net/projects/markdown/
Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言,創(chuàng)始人為約翰·格魯伯(John Gruber)。它允許人們“使用易讀易寫(xiě)的純文本格式編寫(xiě)文檔,然后轉(zhuǎn)換成有效的XHTML(或者HTML)文檔”。[4]
這種語(yǔ)言吸收了很多在電子郵件中已有的純文本標(biāo)記的特性。
John Gruber 在 2004 年創(chuàng)造了 Markdown 語(yǔ)言,在語(yǔ)法上有很大一部分是跟 Aaron Swartz 共同合作的。這個(gè)語(yǔ)言的目的是希望大家使用“易于閱讀、易于撰寫(xiě)的純文字格式,并選擇性的轉(zhuǎn)換成有效的 XHTML (或是HTML)”。 其中最重要的設(shè)計(jì)是可讀性,也就是說(shuō)這個(gè)語(yǔ)言應(yīng)該要能直接在字面上的被閱讀,而不用被一些格式化指令標(biāo)記 (像是 RTF 與 HTML)。 因此,它是現(xiàn)行電子郵件標(biāo)記格式的慣例,雖然它也借鏡了很多早期的標(biāo)記語(yǔ)言,如:setext、Texile、reStructuredText。 許多網(wǎng)站都使用 Markdown 或是其變種,例如:GitHub、reddit、Diaspora、Stack Exchange、OpenStreetMap 與 SourceForge 讓用戶更利于討論。
Markdown同時(shí)還是一個(gè)由Gruber編寫(xiě)的Perl腳本:Markdown.pl。它把用markdown語(yǔ)法編寫(xiě)的內(nèi)容轉(zhuǎn)換成有效的、結(jié)構(gòu)良好的XHTML或HTML內(nèi)容,并將左尖括號(hào)('<')和&號(hào)替換成它們各自的字符實(shí)體引用。它可以用作單獨(dú)的腳本,Blosxom和Movable Type的插件又或者BBEdit的文本過(guò)濾器.[4]
Markdown也已經(jīng)被其他人用Perl和別的編程語(yǔ)言重新實(shí)現(xiàn),其中一個(gè)Perl模塊放在了CPAN(Text::Markdown)上。它基于一個(gè)BSD風(fēng)格的許可證分發(fā)并可以作為幾個(gè)內(nèi)容管理系統(tǒng)的插件。[6]
[7]
目錄
[隱藏]
1圖片
2換行
3強(qiáng)調(diào)
4標(biāo)題
5斷行
6引用
7鏈接
8水平分區(qū)線
9Markdown的用戶
10編輯器
11實(shí)現(xiàn)版本11.1C
11.2Java
11.3Lua
11.4PHP
11.5Ruby
11.6其它
圖片[編輯]

換行[編輯]
在文本中輸入的換行會(huì)從最終生成的結(jié)果中刪除,瀏覽器會(huì)根據(jù)可用空間自動(dòng)換行。如果想強(qiáng)迫換行,可以在行尾插入至少兩個(gè)空格。
強(qiáng)調(diào)[編輯]
強(qiáng)調(diào) 或者 強(qiáng)調(diào) (示例:斜體) 加重強(qiáng)調(diào) 或者 加重強(qiáng)調(diào)
又或者以制表符或至少四個(gè)空格縮進(jìn)的行,例如:
第一行代碼 第二行代碼 第三行代碼
后面一種用法會(huì)讓Markdown保留所有的空白字符——而與之相反,一般情況下,Markdown會(huì)刪除所有換行和空格,打亂原有的縮進(jìn)和排版。
·文字&其它·
·頭像·
·網(wǎng)名·
·生活·
標(biāo)題[編輯]
可以在標(biāo)題內(nèi)容前輸入特定數(shù)量的井號(hào)('#')來(lái)實(shí)現(xiàn)對(duì)應(yīng)級(jí)別的HTML樣式的標(biāo)題(HTML提供六級(jí)標(biāo)題)。例如:
一級(jí)標(biāo)題
四級(jí)標(biāo)題
一級(jí)和二級(jí)標(biāo)題還有一種寫(xiě)法:
一級(jí)標(biāo)題===================二級(jí)標(biāo)題--------------------
斷行[編輯]
如果你真的想在Markdown中插入換行標(biāo)簽
,你可以在行尾輸入兩個(gè)或以上的空格,然后回車(chē)。 這樣插入換行十分麻煩,但是“每個(gè)換行都轉(zhuǎn)換為
”在 Markdown中并不合適,所以只在你確定你需要時(shí)手動(dòng)添加。
引用[編輯]
引用只需要在被引用的內(nèi)容段落開(kāi)頭加上右尖括號(hào)('>')即可。你可以選擇只在開(kāi)頭加一個(gè)。也可以在每行前面都加一個(gè),效果是一樣的。
這一整段的內(nèi)容都會(huì)作為一個(gè)HTML的引用元素。引用元素是會(huì)自動(dòng)優(yōu)化排版的(reflowable,可回流)。你可以任意地將引用的內(nèi)容包含進(jìn)來(lái),然后所有這些都會(huì)被解析成為單獨(dú)一個(gè)引用元素。
上述內(nèi)容會(huì)轉(zhuǎn)換成以下HTML內(nèi)容:
<blockquote><p>這一整段的內(nèi)容都會(huì)作為一個(gè)HTML的引用元素。引用元素是會(huì)自動(dòng)優(yōu)化排版的(reflowable,可回流)。你可以任意地將引用的內(nèi)容包含進(jìn)來(lái),然后所有這些都會(huì)被解析成為單獨(dú)一個(gè)引用元素。</p></blockquote>
引用可以嵌套。如果要在一個(gè)引用里插入一個(gè)引用,可以用兩個(gè)('>')開(kāi)頭。依此類(lèi)推,根據(jù)嵌套層次加相應(yīng)數(shù)量的符號(hào)。
這是一個(gè)引用。這是第一行這是第二行。>> 這是一個(gè)嵌套的引用。這是第一行。這是第二行> > 外層引用的第三行。前面需要一個(gè)視覺(jué)上的空行表示內(nèi)層嵌套的結(jié)束,空行前面的('>')可以有可以沒(méi)有。
鏈接[編輯]
鏈接可以在行內(nèi)插入:
鏈接文字例子: Markdown
另一種選擇是,鏈接地址可以放在段落后面的腳注,前面放上鏈接引用標(biāo)簽區(qū)分。舉例說(shuō),先在內(nèi)容行內(nèi)插入以下內(nèi)容:
[鏈接文字][鏈接引用標(biāo)簽]
然后在段落的后面(或者文檔的結(jié)尾)放上以下內(nèi)容,就可以生成一個(gè)鏈接:
[鏈接引用標(biāo)簽]: 鏈接地址 "鏈接標(biāo)題"
水平分區(qū)線[編輯]
要生成水平分區(qū)線,可以在單獨(dú)一行里輸入3個(gè)或以上的短橫線、星號(hào)或者下劃線實(shí)現(xiàn)。短橫線和星號(hào)之間可以輸入任意空格。以下每一行都產(chǎn)生一條水平分區(qū)線。
Bitbucket 提供Markdown作為編寫(xiě)項(xiàng)目README文檔的其中一種標(biāo)記語(yǔ)言。[9]
DIASPORA* 使用Markdown格式化用戶發(fā)送的消息、評(píng)論和對(duì)話。[10]
Drupal 是一個(gè)Markdown插件[11]
,始創(chuàng)于2008年。截止2011年11月,已有8000個(gè)建站軟件使用了該插件。
Ghost 使用Markdown的一個(gè)標(biāo)準(zhǔn)版本編輯器來(lái)格式化撰寫(xiě)的文章。[12]
GitHub 使用Markdown的一個(gè)分支版本來(lái)格式化評(píng)論、消息以及其它內(nèi)容。[13]
[14]
John Gruber has described this dialect as a "superior variant" for "situations like user-submitted comments".[15]
G+ Tweaks v1.1151,一個(gè)適用于 Google+ 的 Greasemonkey 用戶腳本。[16]
Instiki uses a Markdown extension to wiki syntax. The extended syntax is called Maruku.[17]
Moodle 提供 Markdown 作為語(yǔ)法標(biāo)記語(yǔ)言。[18]
Posterous 提供 Markdown 作為語(yǔ)法標(biāo)記語(yǔ)言。[19]
Reddit 的編輯器使用了 Markdown 語(yǔ)法。[20]
Showoff 使用 Markdown 作為提交的語(yǔ)法。[21]
Squarespace 在博客界面下提供 Markdown 編輯器。[22]
Stack Overflow 以及其他 Stack Exchange Network 網(wǎng)站使用一種 Markdown 的分支作為它的文章格式化系統(tǒng)。[23]
[24]
Typecho 原生支持Markdown編輯器,實(shí)時(shí)預(yù)覽. [26]
The WordPress plugin system utilizes a dialect of Markdown in "readme.txt" files submitted by developers, and has plugins for Markdown.[27]
Second Gear's Elements app for iPhone and iPad gained Markdown capability with its v2 around November of 2010.[28]
圖靈社區(qū) 使用markdown語(yǔ)法供用戶寫(xiě)作電子書(shū).
簡(jiǎn)書(shū) 寫(xiě)作網(wǎng)站,支持 Markdown
為知筆記 是一種類(lèi)似 印象筆記 的筆記軟件,支持使用Markdown語(yǔ)法編輯筆記
HackMD是一個(gè)支持Markdown的在線語(yǔ)法編輯筆記網(wǎng)站,可即時(shí)切換源代碼與成果查看。
編輯器[編輯]
作為一種小型標(biāo)記語(yǔ)言,Markdown很容易閱讀,也很容易用普通的文本編輯器編輯。另外也有一些編輯器專為Markdown設(shè)計(jì),可以直接預(yù)覽文檔的樣式。下面有一些編輯器可供參考:
Cmd Markdown Cmd Markdown 編輯閱讀器,支持實(shí)時(shí)同步預(yù)覽,區(qū)分寫(xiě)作和閱讀模式,支持在線存儲(chǔ),分享文稿網(wǎng)址。
Dillinger.io 一個(gè)在線Markdown編輯器,提供實(shí)時(shí)預(yù)覽以及到 GitHub 和 Dropbox 的拓展連接。
notepag 另一個(gè)在線Markdown編輯器,支持實(shí)時(shí)預(yù)覽,提供臨時(shí)網(wǎng)址和和密碼,可以分享給其他人。
簡(jiǎn)書(shū) 一個(gè)在線Markdown編輯器與閱讀社區(qū),支持實(shí)時(shí)預(yù)覽,提供分享網(wǎng)址。
Mou 一個(gè)Mac OS X上的Markdown編輯器。
MacDown OS X 上的 Markdown 開(kāi)源編輯器,作者稱其深受 Mou 啟發(fā)。
MarkdownPad Windows上的全功能Markdown編輯器。
WMD a Javascript "WYSIWYM" editor for Markdown (from AttackLab)
PageDown 一個(gè)Javascript寫(xiě)的 "WYSIWYM"(所見(jiàn)即所得)Markdown編輯器 (來(lái)自 StackOverflow)
IPython Notebook 以IPython為后臺(tái),利用瀏覽器做IDE,支持Markdown與LaTex公式。
實(shí)現(xiàn)版本[編輯]
由于Markdown的易讀易寫(xiě),很多人用不同的編程語(yǔ)言實(shí)現(xiàn)了多個(gè)版本的解析器和生成器。下面是一個(gè)按編程語(yǔ)言排序的實(shí)現(xiàn)列表。