【问题标题】:Is there a complete Markdown reference somewhere? I mean COMPLETE某处是否有完整的 Markdown 参考?我的意思是完成
【发布时间】:2013-12-15 04:09:59
【问题描述】:

我一直在查看各种 Markdown 备忘单和参考资料。它们都不是真正全面的。我知道这一点,因为有一个看起来像这样的文本居中语法:

-> Centered Text <-

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

【问题讨论】:

标签: markdown


【解决方案1】:

2015-03-02 更新

CommonMark 旨在成为版本号 1.0 后唯一的规范

我们提出了一个标准的、明确的 Markdown 语法规范,以及一套综合测试来验证 Markdown 实现是否符合该规范

...

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


  1. 出于兼容性的目的,我使用 Pandoc 工具所描述和支持的 Markdown 语法作为事实上的完整参考。

    对我来说,如果 Pandoc 降价支持某个功能,我可以使用它,因为如果需要,Pandoc 可用于将其往返传输到另一种工具或格式。

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

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

    StackEdit 支持的语法是 GitHub 风格和 Markdown Extra 的组合,这里有描述

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

【讨论】:

  • 对 Pandoc 的好电话,这是一个很好的资源,也是关于往返它的一个好点。
【解决方案2】:

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

  1. John Gruber's original standard
  2. GitHub Flavored Markdown
  3. MultiMarkdown User Guide (PDF)

虽然还有其他 GitHub 和 MMD 和你一样好,因为它们足够流行,可以在 Markdown 解析器中得到很好的支持。

您可以安全地使用原始标准中的任何内容,并使其适用于所有解析器。 GitHub、MultiMarkdown 和其他扩展使用的附加功能远没有标准化。即使在不同的标准之间,特定的功能支持也可能非常;特别是 MMD 的脚注在一些 Markdown 生态系统(如 iOS 文本编辑器)中变得相当普遍。

换句话说,您可以放心地使用它并坚持原始标准或混合搭配附加功能,但您需要了解您使用的工具,以便您可以决定哪些功能适合您和您的系统。

我的建议是根据需要向 Markdown 添加扩展。当您添加一个新系统时,请检查您所有的 Markdown 工具,找出哪些支持这些功能,哪些不支持。记下它们,然后将其他文档添加到您的书签/笔记/下载/等中。

除了上面那三个我也很喜欢CriticMarkup,如果你需要做很多编辑,尤其是协作,那就太棒了。我将其包含在内是因为它已明确设计为由人类解析并在您进行最终输出之前将其删除,因此它不会弄乱您的工具。

希望对你有帮助。

【讨论】:

    【解决方案3】:

    John Gruber 的Markdown Syntax 页面具有原始 降价语法。但是,没有completedefinitive 参考,因为有很多实现,而且实现很可能不同。例如,GitHub Flavored Markdown 有一些区别,并提供了一些附加功能。

    您最好将您的问题直接发送给您正在使用的 Markdown 的作者或社区,因为可以获得特定实现的完整参考。否则,最好的选择是坚持使用 Gruber。

    【讨论】:

      猜你喜欢
      • 2010-11-21
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多