【问题标题】:GitHub wikis and MarkdownGitHub wiki 和 Markdown
【发布时间】:2012-09-12 02:05:15
【问题描述】:

阅读 GitHub wiki,我看到它们支持包括 MarkDown 在内的几种轻量级标记语言,但我仍然对 Markdown 的状态和功能以及 GitHub 使用的版本有点困惑。

Q1. 在此链接中:Introduction to the GitHub flavored Markdown (GFM),GitHub 表示他们使用 GFM,一种特殊类型的 Markdown (MD) 用于消息、问题和 cmets。他们是否也在 Wiki 上使用 GFM 或常规 MD

Q2原来的 Markdown 还在开发中吗?

Q3 original Markdown 是否支持特定于编程语言的语法高亮显示?

【问题讨论】:

    标签: github wiki markdown


    【解决方案1】:

    他们是否也在 Wiki 上使用 GFM 或常规 MD?

    并非整个 GitHub Flavored Markdown 都可以在 wiki 页面中使用。

    例如,在 wiki 中,#123 之类的内容不会自动链接到当前存储库中的问题 123。但是,在拉取请求或内联评论中,这是可行的。

    原来的 Markdown 还在开发中吗?

    我不知道。最新正式发布日期为 2004 年 12 月 17 日。

    为了解决一些安全问题,代码已由 StackOverflow 团队分叉并托管在 derobins/wmd。现在已弃用,取而代之的是 PageDown。 GitHub 依赖于 Sundown,这是基于 Natacha Porte 的 UpSkirt 库对 MarkDown 的原生重新实现。

    原始 Markdown 是否支持特定于编程语言的语法高亮显示?

    没有。这甚至可能被认为是与 MarkDown 哲学的边界。

    该网站确实声明 “Markdown 旨在尽可能易于阅读和编写。然而,可读性是最重要的。Markdown 格式的文档应该是可发布的照原样,作为纯文本,看起来没有用标签或格式说明进行标记。”

    GitHub 通过使用 Pygments 处理语法高亮。

    【讨论】:

    • 谢谢!但我对您对 Q1 和 Q3 的回答感到困惑。 GitHub wikis 支持特定于编程语言的语法突出显示(我可以使用语法 ``````ruby\n 代码\n 代码\n). Also, as far as I understand the `````code 语法不受原始 MD 支持。我错了吗?
    • 你是对的!我已经更新了答案。代码块也是原始 MarkDown 规范的一部分。但是,这依赖于缩进而不是反引号。
    • 感谢上帝,他们不在 wiki 和其他 .md 文件中使用 GFM。尽管 GFM 的大部分内容都很好,但整个“所有换行符都是硬换行符”对于除了小的 web cmets 之外的任何东西来说都是一个糟糕的设计。
    猜你喜欢
    • 2014-08-14
    • 2017-05-05
    • 2016-04-20
    • 1970-01-01
    • 1970-01-01
    • 2018-02-22
    • 2013-03-09
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多