【问题标题】:Failing to render a header on GitHub无法在 GitHub 上呈现标题
【发布时间】:2017-08-07 04:42:15
【问题描述】:

这是我在 GitHub 存储库中的 README.md

###This is a Header
This is not a Header

这两行都呈现为纯文本。第一个应该呈现为 Header,我记得之前是这样的。

我不知道我的浏览器出了什么问题(macOS 上的 Chrome),我尝试了 Firefox 和 Opera,但没有任何帮助。

【问题讨论】:

    标签: github browser markdown


    【解决方案1】:

    在# 后面加一个空格。看来有必要了。

    【讨论】:

      【解决方案2】:

      这不是您的浏览器的问题。我也发现了同样的“错误”。

      GitHub 刚刚将他们的 markdown 渲染器更新为 CommonMark:https://github.com/blog/2333-a-formal-spec-for-github-flavored-markdown

      CommonMark 要求在# 字符和标题之间有空格字符### Header

      ###This is not a Header
      ### This is a Header
      

      虽然我的大部分 MarkDown 编辑器(Typora、MacDown)都会渲染它们 Header:

      【讨论】:

        【解决方案3】:

        根据 the new specification,对于 ATX 样式的标题(强调我的):

        # 字符的开头序列必须后跟空格或行尾。

        ...

        # 字符和 标题的内容,除非标题为空。请注意,许多 目前的实现不需要空间。然而,空间 original ATX implementation 需要...

        【讨论】:

          猜你喜欢
          • 2020-08-22
          • 2018-08-11
          • 1970-01-01
          • 2015-12-14
          • 2017-03-31
          • 2020-07-12
          • 2019-06-17
          • 2018-06-04
          • 2022-12-13
          相关资源
          最近更新 更多