GitHub сатанински балуется с Markdown - меняет 666 на DCLXVI

В моем репозитории GitHub есть только readme. В этом readme локально я написал это:

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, и почему отступы в ненумерованном списке испорчены? Это пасхальное яйцо или какой-то сатанинский жук?

Похоже, что за этим следует выпуск 991 github / markup , где в упорядоченном подсписке десятичные цифры автоматически превращаются в римские.

Я нашел причину проблемы. Это CSS

Это ожидаемый способ отображения вложенных упорядоченных списков в HTML.

Это не ожидается в HTML. https://jsfiddle.net/tf5jtv8s

Мы не вносим никаких изменений в поведение HTML по умолчанию.

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

Я не знаю CSS, но я понимаю, что это является причиной проблемы. Я могу получить ожидаемый результат, отключив CSS. (Я со своего мобильного телефона, поэтому я не могу использовать инспектор браузера)

Как упомянуто в « Формальной спецификации для GitHub Flavored Markdown », спецификация GitHub Gdown для GFM: GitHub Flavored Markdown основана на спецификации CommonMark .

И как Томми Кайкконен упомянул в своем ответе , упорядоченный список из-за точки, следующей за 666. См. Раздел GFM Spec 5.2 .

Как упомянуто в разделе 6.1 , любой знак препинания ASCII может быть экранирован обратной косой чертой, чтобы избежать этой проблемы.
Это значит:

- 666\. ha.

(как явно показано в ForNeVeR «s ответ )

Вот почему это 666число изменяется на римские цифры в READMEуценке GitHub .

Майк Липперт прокомментировал:

1-й элемент в этом списке, поэтому он должен отображаться как iнет dclxvi.
Упорядоченные списки уценки игнорируют фактическое используемое число и номер последовательно, и я не видел способа изменить это.

Тем не менее, нет: он показывает dclxvi, потому что сгенерированный HTML-код <ol start="666">, который соответствует спецификации GFM :

Если элемент списка упорядочен, то ему также присваивается начальный номер на основе маркера упорядоченного списка ».

(здесь ' 666' - маркер упорядоченного списка)

Майк добавляет:

@VonC Для всех остальных вот еще одна полезная выдержка из ссылки на документацию VonC:

«Начальный номер упорядоченного списка определяется номером списка его первоначального элемента списка. Номера последующих элементов списка не учитываются».

Кроме того, почему интервал испорчен? Я не уловил это в вашем ответе

Вы получаете упорядоченный список <ol>в неупорядоченном элементе списка <li>:

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

Правила CSS GitHub включают в себя:

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

Если вы положите 3em, вы получите вместо

Добавление периода после 666делает его упорядоченным маркером списка .

GitHub объявляет CSS, который отображает упорядоченные маркеры списка, используя римские цифры:

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

Избегайте точки с обратной косой чертой, и вы должны увидеть правильный вывод.

В то время как другие ответы хорошо объясняют, почему у вас есть проблема, они не дали вам точного примера того, как это исправить .

И кажется, что вы уже решили это несовершенным образом , заменив текст

- `666`. ha.

Есть обычная хитрость, позволяющая избежать точки после числа, чтобы она выглядела как обычный текст (а не как упорядоченная метка списка):

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