GitHub gây rối một cách điên cuồng với Markdown - thay đổi 666 thành DCLXVI

Kho lưu trữ GitHub của tôi không có gì ngoài một readme trong đó. Trong readme này, tại địa phương tôi đã viết thế này:

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.

Nhấn mạnh vào dòng cuối cùng. Có gì GitHub quyết định chương trình là không 666 .

DCLXVIlà số La Mã cho 666 .

Điều này thực sự khiến tôi kinh hãi. Tệp cục bộ của tôi và tệp thô đều hiển thị 666.

GitHub đang làm gì và tại sao phần thụt lề trên danh sách chưa được đánh số bị lộn xộn? Đây là một quả trứng Phục sinh, hay một con bọ satan nào đó?

Điều này dường như được theo sau bởi github / markup issue 991 , trong đó trên danh sách phụ có thứ tự, các chữ số thập phân tự động chuyển thành chữ số La Mã.

Tôi đã tìm ra nguyên nhân của vấn đề. Nó là CSS

Đây là cách mong đợi để các danh sách có thứ tự lồng nhau hiển thị trong HTML.

Điều này không được mong đợi trong HTML. https://jsfiddle.net/tf5jtv8s

Chúng tôi không thực hiện bất kỳ sửa đổi nào đối với hành vi HTML mặc định.

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

Tôi không biết CSS nhưng sự hiểu biết của tôi là đây là nguyên nhân của vấn đề. Tôi có thể nhận được kết quả mong đợi bằng cách tắt CSS. (Tôi đến từ điện thoại di động của mình nên tôi không thể sử dụng trình kiểm tra trình duyệt)

Như đã đề cập trong " Một thông số kỹ thuật chính thức cho GitHub Flavored Markdown ", thông số đánh dấu GitHub GFM: GitHub Flavored Markdown Spec được xây dựng dựa trên Thông số chung của CommonMark .

Và như Tommi Kaikkonen đã đề cập trong câu trả lời của mình , danh sách được sắp xếp là do dấu chấm theo sau 666. Xem phần 5.2 Thông số GFM .

Như đã đề cập trong phần 6.1 , bất kỳ ký tự dấu câu ASCII nào đều có thể thoát ra sau dấu gạch chéo ngược, để tránh vấn đề này.
Điều đó có nghĩa là:

- 666\. ha.

(như được hiển thị rõ ràng trong câu trả lời của ForNeVeR )

Đó là lý do tại sao 666số đó được thay đổi thành chữ số la mã trong đánh dấu GitHub README.

Mike Lippert bình luận:

phần tử đầu tiên trong danh sách đó nên nó sẽ hiển thị là ikhông dclxvi.
Danh sách có thứ tự Markdown bỏ qua số thực tế được sử dụng và đánh số theo thứ tự, và tôi chưa thấy cách nào để thay đổi điều đó.

Tuy nhiên, không: nó hiển thị dclxvi, bởi vì mã html được tạo <ol start="666">, phù hợp với thông số kỹ thuật GFM :

Nếu mục danh sách được đặt hàng, thì nó cũng được gán một số bắt đầu, dựa trên điểm đánh dấu danh sách được sắp xếp "

(đây, ' 666' là điểm đánh dấu danh sách có thứ tự)

Mike cho biết thêm:

@VonC Đối với bất kỳ ai khác, đây là một đoạn trích hữu ích khác từ liên kết tài liệu của VonC:

"Số bắt đầu của một danh sách có thứ tự được xác định bởi số danh sách của mục danh sách ban đầu của nó. Số lượng của các mục trong danh sách tiếp theo được bỏ qua."

Ngoài ra, tại sao khoảng cách lại bị lộn xộn? Tôi không hiểu điều đó trong câu trả lời của bạn

Bạn nhận được một danh sách đã đặt hàng <ol>trong một mục danh sách chưa được đặt hàng <li> :

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

Các quy tắc CSS của GitHub bao gồm:

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

Nếu bạn đặt 3em, bạn sẽ nhận được

thay vì

Thêm dấu chấm vào sau 666làm cho nó trở thành một điểm đánh dấu danh sách có thứ tự .

GitHub tuyên bố CSS hiển thị các điểm đánh dấu danh sách có thứ tự bằng cách sử dụng các chữ số la mã:

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

Thoát khỏi khoảng thời gian bằng dấu gạch chéo ngược và bạn sẽ thấy đầu ra chính xác.

Mặc dù các câu trả lời khác rất tốt trong việc giải thích lý do tại sao bạn gặp sự cố, nhưng chúng vẫn chưa cung cấp cho bạn một ví dụ chính xác về cách khắc phục điều đó.

Và có vẻ như bạn đã giải quyết nó theo cách không hoàn hảo , thay thế văn bản của bạn bằng

- `666`. ha.

Có một mẹo phổ biến để thoát khỏi dấu chấm sau số để làm cho nó trông giống như một văn bản bình thường (và không phải là một nhãn danh sách có thứ tự):

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