GitHub satanistycznie zadziera z Markdown - zmienia 666 na DCLXVI

W moim repozytorium GitHub jest tylko plik Readme. W tym pliku Readme napisałem lokalnie:

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.

Nacisk na ostatnią linię. To, co GitHub postanowił pokazać, nie było 666.

DCLXVIjest liczbą rzymską na 666 .

To mnie naprawdę przeraziło. Mój plik lokalny i plik raw są wyświetlane 666.

Co robi GitHub i dlaczego zagłębienie się na liście nienumerowanej jest pomieszane? Czy to easter egg, czy jakiś satanistyczny pluskwa?

Wydaje się, że po tym następuje numer github / markup 991 , w którym na uporządkowanej liście podrzędnej cyfry dziesiętne automatycznie zamieniają się w cyfry rzymskie.

Znalazłem przyczynę problemu. To jest CSS

Jest to oczekiwany sposób renderowania zagnieżdżonych list w HTML.

Nie jest to oczekiwane w HTML. https://jsfiddle.net/tf5jtv8s

Nie wprowadzamy żadnych zmian w domyślnym zachowaniu HTML.

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

Nie znam CSS, ale rozumiem, że to jest przyczyną problemu. Mogę uzyskać oczekiwany wynik, wyłączając CSS. (Jestem z telefonu komórkowego, więc nie mogę korzystać z inspektora przeglądarki)

Jak wspomniano w „ Formalnej specyfikacji dla GitHub Flavoured Markdown ”, GitHub dla markdown spec GFM: GitHub Flavored Markdown spec jest zbudowany na specyfikacji CommonMark .

I jak wspomniał Tommi Kaikkonen w swojej odpowiedzi , lista uporządkowana wynika z kropki po 666. Patrz sekcja 5.2 specyfikacji GFM .

Jak wspomniano w sekcji 6.1 , każdy znak interpunkcyjny ASCII może być poprzedzony ukośnikiem, aby uniknąć tego problemu.
To znaczy:

- 666\. ha.

(jak wyraźnie pokazano na ForNeVeR „s odpowiedź )

Dlatego ta 666liczba jest zmieniana na cyfry rzymskie w przecenie GitHub README.

Mike Lippert skomentował:

pierwszy element na tej liście, więc powinien być wyświetlany jako inie dclxvi.
Listy uporządkowane Markdown ignorują faktyczny numer i numer sekwencyjnie, a ja nie widziałem sposobu, aby to zmienić.

Jednak nie: pokazuje dclxvi, ponieważ wygenerowany kod HTML <ol start="666">jest zgodny ze specyfikacjami GFM :

Jeśli pozycja na liście jest zamówiona, wówczas przypisywany jest jej również numer początkowy na podstawie zamówionego znacznika listy „

(tutaj „ 666” oznacza znacznik listy uporządkowanej)

Mike dodaje:

@VonC Dla każdego innego oto kolejny przydatny fragment linku do dokumentu VonC:

„Początkowy numer uporządkowanej listy zależy od numeru początkowej pozycji na liście. Liczby kolejnych pozycji na liście są pomijane”.

Ponadto, dlaczego odstępy są pomieszane? Nie zrozumiałem tego w twojej odpowiedzi

Otrzymujesz uporządkowaną listę <ol>w obrębie niezamówionej pozycji na liście <li>:

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

Reguły GitHub CSS obejmują:

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

Jeśli umieścisz 3em, dostaniesz zamiast

Dodanie kropki po 666powoduje, że jest to znacznik listy uporządkowanej .

GitHub deklaruje CSS, który renderuje uporządkowane znaczniki listy za pomocą cyfr rzymskich:

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

Ucieknij kropkę odwrotnym ukośnikiem i powinieneś zobaczyć poprawne wyjście.

Podczas gdy inne odpowiedzi dobrze wyjaśniają, dlaczego masz problem, nie podały dokładnego przykładu, jak to naprawić .

I wygląda na to, że rozwiązałeś go już niedoskonale , zastępując tekst

- `666`. ha.

Istnieje wspólna sztuczka polegająca na ucieczce przed kropką po numerze, aby wyglądała jak zwykły tekst (a nie uporządkowana etykieta listy):

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