Markdown
Markdown是一种轻量级标记语言,创始人为約翰·格魯伯。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。[4]这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
text/markdown [1] | |
统一类型标识 | net.daringfireball.markdown |
开发者 | 約翰·格魯伯(與亞倫·斯沃茨在語法上合作) |
初始版本 | 2004年3月19日[2][3] |
最新版本 | 1.0.1 (2004年12月17日[4]) |
格式类型 | 标记语言 |
延伸成 | MultiMarkdown, Markdown Extra, CommonMark[5] |
自由格式 | yes[6] |
网站 | daringfireball |
由於Markdown的輕量化、易讀易寫特性,並且對於圖片,圖表、數學式都有支援,目前許多網站都廣泛使用Markdown來撰寫說明文件或是用於論壇上發表訊息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被用來撰寫電子書。
历史
約翰·格魯伯在2004年創造了Markdown語言,在語法上有很大一部分是跟亚伦·斯沃茨共同合作的。這個語言的目的是希望大家使用「易於閱讀、易於撰寫的純文字格式,並選擇性的轉換成有效的XHTML(或是HTML)」。
其中最重要的設計是可讀性,也就是說這個語言應該要能直接在字面上的被閱讀,而不用被一些格式化指令標記(像是RTF與HTML)。
因此,它是現行電子郵件標記格式的慣例,雖然它也借鑒了幾個早期的標記語言,如:Setext、Textile (markup language)、reStructuredText。格魯伯也编写了的Perl脚本:Markdown.pl,用於把markdown语法编写的内容转换成有效的、结构良好的XHTML或HTML内容,并将左尖括号<
和&
号替换成它们各自的字符实体引用。它可以用作单独的脚本,Blosxom和Movable Type的插件又或者BBEdit的文本过滤器[4]。Markdown也已经被其他人用Perl和别的编程语言重新实现,其中一个Perl模块放在了CPAN(Text::Markdown)上。它基于一个BSD风格的许可证分发并可以作为几个内容管理系统的插件[7][8]。
标准化
Markdown已经成为典型的转换为HTML的非正式规范[9]和参考实现。随着时间的推移,出现了许多Markdown实现。人们开发这些主要是由于在基本语法之上需要额外的功能 - 例如表格,脚注,定义列表(技术上的HTML描述列表)和HTML块内的Markdown。其中一些行为偏离了最开始的参考实现。与此同时,非正式规范中的一些含糊不清引起了人们的注意[10]。这些问题促使Markdown解析器的一些开发人员努力实现标准化。
Babelmark[11][12]是一个可用于比较各种实现的输出的工具,以促进关于如何以及是否应该阐明markdown规范的某些模糊方面的讨论。[13]格魯伯认为不应完全标准化:“不同的网站(和人们)有不同的需求。没有一种语法可以让所有人满意。”[14]
2016年3月发布了RFC 7763和RFC 7764。RFC 7763 从原始变体引入了MIME类型 text/markdown
。RFC 7764讨论并注册了MultiMarkdown、GitHub Flavored Markdown (GFM)、Pandoc、CommonMark及Markdown等变体。[15]
从2012年开始,包括Jeff Atwood和John MacFarlane在内的一群人启动了标准化工作。[16]一个社区网站现在旨在记录可用于文档作者和开发人员的各种工具和资源,以及各种markdown实现的实现者。[17] 2014年9月,格魯伯反对在这一工作中继续使用“Markdown”这个名字,其被更名为CommonMark。[18][19]CommonMark.org发布了规范、参考实现和测试套件的几个版本,并计划在2018年宣布最终的1.0规范和测试套件。[20]
示例
Markdown語法 | 由Markdown處理器產生的HTML | 瀏覽器顯示效果 |
---|---|---|
# 一级標題
## 二级標題
段落以空白行分隔。
行末兩個空格 産生斷行。
文本屬性:_斜體_、
**粗體**、`等寬字型Monospace`。
水平線:
---
列表:
* 張三
* 李四
* 王二
編號列表:
1. 不論
2. 三七
3. 二十一
[連結](http://example.com)
![圖](Icon-pictures.png "icon")
> Markdown使用電郵用字元「>」來引用。
行間<abbr title="Hypertext Markup Language">HTML</abbr>亦受支援。
|
<h1>一级標題</h1>
<h2>二级標題</h2>
<p>段落以空白行分隔。</p>
<p>行末兩個空格<br />
產生斷行。</p>
<p>文本屬性<em>斜體</em>、
<strong>粗體</strong>、<code>等寬字型Monospace</code>。</p>
<p>水平線:</p>
<hr />
<p>列表:</p>
<ul>
<li>張三</li>
<li>李四</li>
<li>王二</li>
</ul>
<p>編號列表:</p>
<ol>
<li>不論</li>
<li>三七</li>
<li>二十一</li>
</ol>
<p><a href="http://example.com">連結</a>。</p>
<p><img alt="圖" title="icon" src="Icon-pictures.png" /></p>
<blockquote>
<p>Markdown使用電郵用字元「>」來引用。</p>
</blockquote>
<p>行間<abbr title="Hypertext Markup Language">HTML</abbr>亦受支援。</p>
|
段落以空白行分隔。 行末兩個空格 文本屬性:斜體、
粗體、 水平線: 列表:
編號列表:
行間HTML亦受支持。 |
实现
Markdown的实现可用于十几种编程语言;此外,许多平台和框架都支持Markdown。[28] 例如,Markdown插件适用于每个主要的博客平台。[29]
虽然Markdown是一种最小标记语言,并且使用普通文本编辑器进行读取和编辑,但是有专门设计的编辑器可以预览具有样式的文件,这些样式可用于所有主要平台。许多通用文本和代码编辑器都具有内置于其中的Markdown的语法高亮插件,或者可用作可选下载。编辑器可以具有并排预览窗口或直接以所见即所得的方式呈现代码。
- 源代码文档生成器Doxygen支持Markdown的额外功能。[30]
- RStudio是一个用于R的IDE,为称为sundown的markdown变体提供了C ++包装函数。[31]
- GitHub Flavored Markdown(GFM)忽略单词中的下划线,并添加语法高亮显示,任务列表[32]和表格[33]。
- Discount – 一个C语言实现。[34][35]
- MarkAPL是一个用Dyalog APL编写的转换器。它支持隔离块,智能排版,链接引用和特殊属性,并可以生成目录。[36]
- PHP Markdown - 一个库包,包含PHP Markdown解析器及其有额外功能的兄弟PHP Markdown Extra。[37]
- Markdig - 遵循CommonMark规范的.NET库,包括一组扩展和用户创建自己扩展的能力。
- WP Githuber MD - 一个WordPress 插件,实现了所见即所得的 Markdown 编辑器及增强语法。[38]
- Visual Studio Code 對 Markdown 的支援度極高[39]。
参考文献
- RFC 7763 页面存档备份,存于 - The text/markdown Media Type
- Swartz, Aaron. . Aaron Swartz: The Weblog. 2004-03-19 [2016-02-04]. (原始内容存档于2017-12-24).
- Gruber, John. . Daring Fireball. [2014-04-25]. (原始内容存档于2004-04-02).
- Markdown 1.0.1 readme source code . 17-Dec-2004 [2012-03-19]. (原始内容存档于2004-04-02).
- RFC7764 页面存档备份,存于 – Guidance on Markdown: Design Philosophies, Stability Strategies, and Select Registrations
- . Daring Fireball. [2014-04-25]. (原始内容存档于2020-02-18).
- . [2009-08-11]. (原始内容存档于2011-08-21).
- . [2009-08-11]. (原始内容存档于2011-06-07).
- . [2019-02-18]. (原始内容存档于2019-09-09).
- . github.github.com. [2017-10-01]. (原始内容存档于2020-02-03).
- . Johnmacfarlane.net. [2014-04-25]. (原始内容存档于2017-07-18).
- . github.io. [2017-12-10]. (原始内容存档于2020-11-12).
- . Johnmacfarlane.net. [2014-04-25]. (原始内容存档于2017-07-28).
- Gruber, John [@gruber]. (推文). 4 September 2014 –Twitter.
- . IANA. 2016-03-28 [2016-07-06]. (原始内容存档于2020-10-27).
- Atwood, Jeff. . CodingHorror.com. 2012-10-25 [2014-04-25]. (原始内容存档于2014-02-11).
- . GitHub. [2014-04-25]. (原始内容存档于2020-10-26).
- . Jeff Atwood. [2014-10-07]. (原始内容存档于2014-10-09).
- . InfoQ. [2014-10-07]. (原始内容存档于2020-09-30).
- . [20 Jun 2018]. (原始内容存档于2016-04-12) (英语).
The current version of the CommonMark spec is complete, and quite robust after a year of public feedback … but not quite final. With your help, we plan to announce a finalized 1.0 spec and test suite in 2018.
- . [2017-10-01]. (原始内容存档于2020-02-03).
- . GitHub Engineering. [16 Mar 2017]. (原始内容存档于2020-02-03).
- Fortin, Michel. . Michel Fortin website. 2018 [2018-12-26]. (原始内容存档于2021-01-17).
- . 4 December 2008 [2019-02-18]. (原始内容存档于2020-09-17).
- . extensions.typo3.org. [2019-02-18]. (原始内容存档于2021-02-01).
- . www.mediawiki.org. [2019-02-18]. (原始内容存档于2020-10-29).
- . Michel Fortin. [2019-02-18]. (原始内容存档于2021-01-17).
- . W3C Markdown Wiki. [24 March 2016]. (原始内容存档于2020-09-17).
- . Ars Technica. 2014-10-05 [2019-02-18]. (原始内容存档于2020-11-14).
- . Stack.nl. 2014-04-21 [2014-04-25]. (原始内容存档于2017-07-18).
- jjallaire; e.a. . GitHub project RStudio. 2015-06-30 [2016-07-07]. (原始内容存档于2017-07-26).
- . help.github.com. GitHub, Inc. [9 July 2014]. (原始内容存档于2018-06-04).
- . github.com. [29 March 2013]. (原始内容存档于2019-02-05).
- . [2014-11-01]. (原始内容存档于2019-10-18).
- David Parsons. . GitHub. 2016-05-28 [2016-07-07]. (原始内容存档于2021-01-16).
位于Open Hub的discount
- . [2019-02-18]. (原始内容存档于2020-12-05).
- . [2016-03-01]. (原始内容存档于2021-01-20).
- . [2018-12-15]. (原始内容存档于2020-12-13).
- . [2019-09-10]. (原始内容存档于2019-02-08).
外部链接
- 官方网站 for original John Gruber markup
- 在线Markdown表格编辑器 页面存档备份,存于