GitHub在Markdown上乱哄哄 - 将666更改为DCLXVI

Question

我的GitHub存储库只有一个自述文件.在本自述文件中,我在本地写道:

Factoids:
 - There are about six different ways to do everything in Forked.
 - There are actually six different ways to enter loops.
 - There are six directionals and six I/O commands.
 - 666. ha.

强调最后一行.GitHub决定展示的不是 666.

DCLXVI是666的罗马数字.

这真的让我感到沮丧.我的本地文件和原始文件都显示666.

什么是GitHub,为什么未编号列表上的缩进搞乱了？这是一个复活节彩蛋,还是一些撒旦虫？

Answer 1

这似乎是github/markup issue 991,其中在有序子列表中,十进制数字自动变成罗马数字.

我找到了问题的原因.这是CSS

这是嵌套有序列表在HTML中呈现的预期方式.

这不是HTML中的预期.https://jsfiddle.net/tf5jtv8s

我们不对默认的HTML行为进行任何修改.

ol ol,ul ol{list-style-type:lower-roman}

我不知道CSS但我的理解是这是问题的原因.我可以通过禁用CSS获得预期的结果.(我来自我的手机所以我不能使用浏览器检查器)

正如" GitHub Flavored Markdown的正式规范 "中所提到的,GitHub降价规格GFM:GitHub Flavored Markdown Spec建立在CommonMark Spec之上 .

正如Tommi Kaikkonen在他的回答中提到的那样,有序列表是因为666之后的点.参见GFM Spec第5.2节.

如6.1节所述,任何ASCII标点字符都可以进行反斜杠转义,以避免此问题.
这意味着:

- 666\. ha.

(正如ForNeVeR的答案中明确显示的那样)

这就是为什么666在GitHub README降价中将该数字更改为罗马数字的原因.

Mike Lippert评论道:

该列表中的第一个元素,因此它应该显示为i不dclxvi.
Markdown有序列表忽略了实际使用的数字和顺序编号,我还没有看到改变它的方法.

但是,没有:它显示dclxvi,因为生成的html代码是<ol start="666">,这与GFM规范一致:

如果订购了列表项,则还会根据有序列表标记为其分配一个起始编号"

(这里,' 666'是有序列表标记)

迈克补充说:

@VonC对于其他任何人来说,这是VonC文档链接的另一个有用的摘录:

"有序列表的起始编号由其初始列表项的列表编号确定.后续列表项的编号将被忽略."

另外,为什么间距搞砸了？在你的回答中,我没有注意到这一点

您将<ol>在未排序的列表项中 获得有序列表<li>:

<ul>
  <li>
    <ol start="666">
      <li>ha.</li>
    </ol>
  </li>
</ul>

GitHub CSS规则包括:

.markdown-body ol {
    padding-left: 2em;
}

如果你放3em,你会得到

代替

Answer 2

添加句点后666使其成为有序列表标记.

GitHub声明使用罗马数字呈现有序列表标记的CSS:

ol ol,ul ol {
    list-style-type: lower-roman
}

使用反斜杠逃避句点,您应该看到正确的输出.

Answer 3

虽然其他答案很好地解释了为什么你有问题,但他们没有给你一个如何解决这个问题的确切例子.

似乎你已经用不完美的方式解决了它,用你的文本替换了

- `666`. ha.

有一个常见的技巧是在数字之后转义点,使其看起来像普通文本(而不是有序列表标签):

- 666\. ha. (this will render as you probably want)