Improved commenting with Markdown
https://github.com/blog/2097-improved-commenting-with-markdown

“ The new toolbar allows you to do so without learning Markdown syntax.”

Github 设计一个新的 Toolbar 来帮助人们避免使用 Markdown 语法。

@proudzhu 谢谢。


CommonMark - A strongly defined, highly compatible specification of Markdown
http://commonmark.org/

CommonMark 尝试给 Markdown 的众多不兼容的版本做一个统一的标准，有点像 Common Lisp 之于 Lisp 。

@bengol 流行的东西并不一定是因为设计的好。 MySQL 比 PostgreSQL 流行，但没有后者设计得好； C#比 Java 设计得好，但没有后者的生态大；天涯论坛用户多，但没有 v 站界面清爽……

有时候，好东西流行起来是要靠运气和资本做推手的。

@FrankFang128 解决这两个痛点就要引入难看的新语法，或者重新设计一个更好的格式。

应该不止两个， 10 楼、 17 楼、 18 楼都是痛点。

@conansix 谢谢。

@sox 评论里面的每一个建设意见或者推荐的 Markdown 的可替代产品都是对 Markdown 存在的问题的肯定。 Markdown 是 11 年前设计的，有些不好的地方很正常的。难道因为 Aaron Swartz 参与了设计我们就不能挑这个设计的问题了吗？我们不能因为某个可敬的人参与了某个软件的设计就对这个软件全盘接受。

Markdown 还有一个问题，就是由 Markdown 文档到 HTML （ XML ）文档的转换是单向的，没有办法可靠地从 HTML 文档生成唯一的 Markdown 文档。

这个问题对于大多数使用场景来说都不是大问题，但还是先记在这里吧。

@cnnblike 谢谢～

Madoko
https://www.madoko.net/

Madoko Reference
http://research.microsoft.com/en-us/um/people/daan/madoko/doc/reference.html

@chloerei @jamesxu 谢谢～ 但我觉得 asciidoc 还是对 Markdown 的补充和更正。

这是 AsciiDoc 的 cheatsheet ，我觉得还是语法太多，对于新手还是要话半天到一天才能感觉自己“都会了”：
http://powerman.name/doc/asciidoc

我想我得说明一下。我曾经是 Markdown 的喜爱者，把 Markdown 当作主要记笔记的格式用过好长一段时间，我花钱买过正版的 MultiMarkdown Composer ，后来作者升级了软件需要再付费后我就很少用了。

另外，有一个需求，可能很多软件工作人员会有，就是在嵌入的代码中着重强调某个 statement (比如把这个 statement 变成斜体)，这个需求好像在 Markdown 中是没有办法实现的。

总结一些 Yin 的文章：

1 ） Markdown 基于空格的格式化容易产生不易察觉的错误；
2 ）某些特殊字符，如“＊”，选择的不合理；
3 ）表达力有限（是 HTML 的小子集）；
4 ）引入了太多的语法，不好记，也没有一致性。

Markdown 的一些问题
http://www.yinwang.org/blog-cn/2013/04/14/markdown/

@Tink Markdown 设计之初就是把自己定位为 HTML 的一个小子集，确实有好多功能都没有考虑进去，现在强加进去只能是各种缝缝补补的 hack ，缺乏设计上的一致性。

@chuhemiao 我没有遇到过写 PHP 的需求，只是在研究某个开源项目（不是 WordPress ；））的时候需要能够读 PHP 代码。

@chuhemiao 我没用过 PHP 的，不知道 PHP 好不好，只是江湖传闻说 PHP 不好，所以问一下有没有好的地方～

Markdown 是有它的问题的，斜体、粗体、标题的语法比较直观，但链接和图片就不那么好了。

多数情况下，用 Markdown 写的文档是要被“渲染”一下才会被看到的，这也是为什么那么多实时渲染的 Markdown 编辑器那么流行。如果， MD 文档最终是要被渲染的，那就解决了是不是易读的问题。是不是易写，也是 MD 的一个问题。举一个“引用”的例子：

引用一段话， Markdown 里要这么写：

> The overriding design goal for Markdown's
> formatting syntax is to make it as readable
> as possible. The idea is that a
> Markdown-formatted document should be
> publishable as-is, as plain text, without
> looking like it's been marked up with tags
> or formatting instructions.

不如这么写容易：

(quote
The overriding design goal for Markdown's
formatting syntax is to make it as readable
as possible. The idea is that a
Markdown-formatted document should be
publishable as-is, as plain text, without
looking like it's been marked up with tags
or formatting instructions.)

如果需要经常改动的话，用 Markdown 就更头疼了。

@soli 其实，能不能给人看是取决于人的。乐谱对于乐师来讲就等于音乐，她们可以看着乐谱头脑里自动播放音乐；对于不懂音乐的人来讲，乐谱就是蝌蚪群：）当然，我们想设计一种简单的语法，尽可能方便人很快读懂，如果复杂成 XML 那样的话倒还不如直接用 XML 好。

Common Lisp inspired syntax - simple to read like Markdown, but that has a stricter syntax
http://lists.suckless.org/dev/1008/5703.html

(h1
A heading)
(p
This is (strong awfully) nice.)
(h2
Another heading)