在某处有完整的Markdown参考吗?我的意思是完整的

时间:2013-12-15 04:10:00

标签: markdown

我一直在寻找各种Markdown备忘单和参考资料。它们都不是真的全面。我知道这是因为有一个文本居中语法如下所示:

-> Centered Text <-

我发现的所有页面都没有提到这一点。任何帮助将不胜感激,提前谢谢。

3 个答案:

答案 0 :(得分:3)

其他评论完全正确。虽然没有一个明确的来源,但我发现我从这三个来源获得了所需的一切:

  1. John Gruber's original standard
  2. GitHub Flavored Markdown
  3. MultiMarkdown User Guide(PDF)
  4. 虽然还有其他人,GitHub和MMD的表现与你的表现一样好,因为它们足以在Markdown解析器中得到很好的支持。

    您可以非常安全地使用原始标准中的任何内容,并使其适用于所有解析器。 GitHub,MultiMarkdown和其他扩展使用的附加功能远没有标准化。即使在不同标准中,特定功能支持也可能非常; MMD的脚注尤其在iOS文本编辑器等Markdown生态系统中变得无处不在。

    换句话说,您可以安全地玩它并坚持原始标准或混合搭配其他功能,但您需要知道您使用的工具,以便您可以决定哪些功能适合您和您的系统。

    我建议您根据需要添加Markdown扩展程序。添加新系统时,请浏览所有Markdown工具,找出哪些功能支持,哪些功能不支持。记下它们,然后将附加文档添加到书签/备注/下载/等。

    除了上述三个,我也很喜欢CriticMarkup,如果你需要做很多编辑,特别是合作,那就太棒了。我包括这个,因为它已被明确设计为由人类解析并在您执行最终输出之前被删除,因此它不会弄乱您的工具。

    我希望有所帮助。

答案 1 :(得分:3)

更新2015-03-02

CommonMark enter image description here一旦达到1.0版本就会成为唯一的规范

  

我们为Markdown提出了一个标准的,明确的语法规范,以及一套针对此规范验证Markdown实现的综合测试

     

...

     

我们是一群Markdown粉丝,他们要么在Markdown的工业规模部署公司工作,写过Markdown解析器,有最终用户支持Markdown的丰富经验 - 或者以上所有


  1. 为了兼容性,我使用Pandoc工具描述和支持的完整参考Markdown语法。

    对我来说,如果 Pandoc markdown 支持某项功能,我可以使用它,因为Pandoc可以用来将其往返另一个工具或格式(如果需要)。

    http://johnmacfarlane.net/pandoc/README.html#pandocs-markdown

  2. 对于简单的偶然写作我使用https://stackedit.io在线编辑器支持的参考功能。

    StackEdit 支持的语法是GitHub flavor和Markdown Extra的组合,在此处描述

    https://github.com/benweet/stackedit/blob/master/public/res/WELCOME.md#markdown-extra

答案 2 :(得分:0)

John Gruber的Markdown Syntax页面具有原始降价语法。但是,没有完整的权威引用,因为有许多实现,并且实现很可能不同。例如,GitHub Flavored Markdown存在一些差异,并提供了一些其他功能。

您最好的选择是将您的问题转发给您正在使用的Markdown的作者或社区,因为有可能获得特定实施的完整参考。否则,最好的办法是坚持使用Gruber。