Markdown（Aaron Swartz 的网络日志）

# Markdown（Aaron Swartz：博客） 来源：http://www.aaronsw.com/weblog/001189 几个月来，我一直在和 John Gruber 合作一个新项目。思路是让写简单网页——尤其是博客文章——像写邮件一样轻松：用几乎一样的纯文本语法，自动转成 HTML。我们把语法细节从头到尾抠了个遍，想搞出最顺手的格式，结果我觉得我们真弄出了点好东西。我们在博客、评论框、邮件里反复试用，效果出奇地好。这个格式，加上 John Gruber 用 Perl 写的实现，就叫 **Markdown**。我强烈推荐：直接插进 Movable Type，写文章瞬间轻松又好玩。 - 官网：http://daringfireball.net/projects/markdown/ - Gruber 宣言：http://daringfireball.net/2004/03/dive_into_markdown John 准备发布前，我又花了俩小时（参考 http://www.aaronsw.com/weblog/000918）写了个反向工具：把 HTML 再变回 Markdown。目前只是最初版，但我扔给它的页面都能对付。（要是遇到 bug 请告诉我。） - html2text：http://www.aaronsw.com/2002/html2text/ 两个项目都是自由软件，GNU GPL 下发布。 *分享并享用！* 发布于 2004 年 3 月 19 日 17:36 [技术](http://www.aaronsw.com/weblog/cat_technology)（[26 条评论](http://www.aaronsw.com/weblog/001189#comments)） --- **评论** # [#](http://www.aaronsw.com/weblog/001189) Markdown 到底为什么存在？reStructuredText 哪里不好了？ —— [Bob Ippolito](http://bob.pycs.net/)，2004-03-19 18:54 # [#](http://www.aaronsw.com/weblog/001189#c726) 有 Python 版 Markdown 吗？ —— [Xian](http://xian.mintchaos.com/)，2004-03-19 21:09 # [#](http://www.aaronsw.com/weblog/001189#c728) Textile 呢？ —— [jazer](http://www.johnzeratsky.com/)，2004-03-19 22:03 # [#](http://www.aaronsw.com/weblog/001189#c729) 我喜欢。说到 reStructuredText，对比下这两份文档就明白了： - reStructuredText 版入门：http://docutils.sourceforge.net/docs/rst/quickstart.txt - Markdown 版入门（html2text 转）：http://www.aaronsw.com/2002/html2text/?url=http%3A%2F%2Fdocutils.sourceforge.net%2Fdocs%2Frst%2Fquickstart.html Markdown 读起来、写起来都轻松。Markdown.pl 还能直接当 blosxom 插件用。（如果用 writeback 插件，我有一行 diff 让它支持 Markdown，见 http://greg.vario.us/software/writeback.patch） —— [Greg](http://greg.vario.us/)，2004-03-20 01:15 # [#](http://www.aaronsw.com/weblog/001189#c734) 大家知道 YAML 吗？我五分钟就学会了，很喜欢！期待多用 Markdown/YAML 这类东西。 —— [Zooko](http://zooko.com/log.html)，2004-03-20 05:48 # [#](http://www.aaronsw.com/weblog/001189#c735) 这是我的博客的 ASCII 版（html2text 转）：http://www.aaronsw.com/2002/html2text/?url=http%3A%2F%2Fzooko.com%2Flog.html，原版：http://zooko.com/log.html。不知道再跑一遍 Markdown 会成啥样？ —— 匿名，2004-03-20 05:54 # [#](http://www.aaronsw.com/weblog/001189#c736) 把 reST 的元数据去掉，或者给 Markdown 加上命名链接，两者读写难度就差不多了。但 reST 更老、工具更多、API 更全，还支持插件扩展。 —— [Bob Ippolito](http://bob.pycs.net/)，2004-03-20 07:07 # [#](http://www.aaronsw.com/weblog/001189#c738) 可 Markdown 的“无语法”就是卖点；普通人写邮件的顺手姿势就能直接发博客。 —— [Gregory](http://greg.vario.us/)，2004-03-20 10:57 # [#](http://www.aaronsw.com/weblog/001189#c740) 我也在写类似的轻量标记工具。现有工具还是太复杂，我梦想能自动画 ASCII 图、自动调色、自动排版食谱…… —— [mx](http://warpedvisions.org/)，2004-03-20 11:54 # [#](http://www.aaronsw.com/weblog/001189#c742) 太酷了，谢谢！ —— [joe](http://pobox.com/~joehall/nqb/)，2004-03-20 13:27 # [#](http://www.aaronsw.com/weblog/001189#c743) 用户更可能懂 HTML——毕竟通用标准——而不是某门新小众语言。 —— [Dominik Rabiej](http://www.dominik.net/)，2004-03-20 14:28 # [#](http://www.aaronsw.com/weblog/001189#c744) Markdown 官网居然一次都没提 Wiki？Wiki 世界早把“每行 4 空格”这类规矩淘汰了啊。 —— Tobias Weber，2004-03-20 14:35 # [#](http://www.aaronsw.com/weblog/001189#c745) 看不出比 reST 强在哪。`# [Structure][11]` 真比 `Structure\n---------` 好？干脆装个 [Epoz](http://epoz.sourceforge.net/) 所见即所得算了。 —— [Richard](http://mechanicalcat.net/richard/log)，2004-03-20 16:04 # [#](http://www.aaronsw.com/weblog/001189#c746) reST 能导出 DocBook。我给完全不懂技术的人发过 reST 格式的邮件，他们照样看得懂。 —— [Bob Ippolito](http://bob.pycs.net/)，2004-03-20 16:19 # [#](http://www.aaronsw.com/weblog/001189#c747) 我超爱 Markdown！混合原生 HTML、智能转义、代码块都是杀手级特性。维基百科也该默认用 Markdown。 —— [Már](http://mar.anomy.net/)，2004-03-20 20:19 # [#](http://www.aaronsw.com/weblog/001189#c753) 小吐槽：说“GNU GPL”有点冗余，就像说“纽约的曼哈顿”。 —— 匿名，2004-03-21 23:08 # [#](http://www.aaronsw.com/weblog/001189#c754) 还有 [Affero GPL](http://www.affero.org/oagpl.html)、[nethack GPL](http://www.opensource.org/licenses/nethack.php) 呢，区分一下没坏处。 —— [Aaron Swartz](http://www.aaronsw.com/)，2004-03-22 00:02 # [#](http://www.aaronsw.com/weblog/001189#c755) Bob 问“为啥不用 reST”——可 reST 没 Perl 实现、也没 Movable Type 单文件插件啊。我更没精力重写 reST 那一堆功能。 —— [John Gruber](http://daringfireball.net/)，2004-03-22 00:12 # [#](http://www.aaronsw.com/weblog/001189#c756) reST 满屏 `_` `:` `..` 看着就头大；Markdown 像普通邮件，干净。 —— [Aaron Swartz](http://www.aaronsw.com/)，2004-03-22 00:23 # [#](http://www.aaronsw.com/weblog/001189#c757) > 有 Python 版 Markdown 吗？ 没有，但可以这样调 Perl： ```python import os def markdown(text): i, o = os.popen2("perl Markdown.pl") i.write(text); i.close() return o.read() ``` —— [Aaron Swartz](http://www.aaronsw.com/)，2004-03-22 00:23 # [#](http://www.aaronsw.com/weblog/001189#c758) Nick Moffitt 用 awk 写了个类似工具 [tron](http://cvs.lnx-bbc.org/cvs/*checkout*/gar/tron.awk?rev=HEAD&content-type=text/plain)，给 [LNX-BBC](http://www.lnx-bbc.org/) 项目用。 —— [Seth Schoen](http://vitanuova.loyalty.org/)，2004-03-22 01:08 # [#](http://www.aaronsw.com/weblog/001189#c761) 有人在写 PHP 版 Markdown 吗？我想集成到个人博客/维基，但不想外部调进程。愿意一起测试修 bug。 —— [Jukka Zitting](mailto:[email protected])，2004-03-22 04:52 # [#](http://www.aaronsw.com/weblog/001189#c762) 我在做 Markdown 维基，计划用 `[[双中括号]]` 当 Wiki 链接，后处理搞定。真成瓶颈再改客户端/服务器模式不迟。 —— [Aaron Swartz](http://www.aaronsw.com/)，2004-03-22 10:53 # [#](http://www.aaronsw.com/weblog/001189#c763) > 有人在写 PHP 版 Markdown 吗？ 目前我没有，但收到好几封邮件说想移植。真有人搞定，我一定在 Daring Fireball 挂链接。不过 Perl 里大量高级正则，直接翻译恐怕得重写。 —— [John Gruber](http://daringfireball.net/)，2004-03-22 13:00