Làm cách nào để thêm chú thích vào Markdown có hương vị GitHub?

Tôi chỉ cố gắng thêm chú thích trong GitHub Gist của mình , nhưng nó không hoạt động:

Some long sentence. [^footnote]

[^footnote]: Test, [Link](https://google.com).

Tôi đang làm theo hướng dẫn này và tôi không nghĩ mình đang làm gì sai. Ai đó có thể chỉ ra sai lầm của tôi?

GitHub Flavored Markdown không hỗ trợ chú thích, nhưng bạn có thể giả mạo nó bằng tay với các ký tự Unicode hoặc thẻ siêu ký tự, ví dụ <sup>1</sup>.

Course Tất nhiên điều này không lý tưởng, vì bây giờ bạn có trách nhiệm duy trì việc đánh số chú thích của mình. Nó hoạt động hợp lý tốt nếu bạn chỉ có một hoặc hai, mặc dù.

Mở rộng một chút về câu trả lời trước, bạn cũng có thể làm cho các liên kết chú thích có thể nhấp vào đây. Đầu tiên hãy xác định chú thích ở phía dưới như thế này

<a name="myfootnote1">1</a>: Footnote content goes here

Sau đó tham khảo nó ở một nơi khác trong tài liệu như thế này

<sup>[1](#myfootnote1)</sup>

Mở rộng các câu trả lời trước hơn nữa, bạn có thể thêm một idthuộc tính vào liên kết chú thích của bạn:

 Bla bla <sup id="a1">[1](#f1)</sup>

Sau đó từ trong phần chú thích, liên kết lại với nó.

<b id="f1">1</b> Footnote content here. [↩](#a1)

Điều này sẽ thêm một chút ↩vào cuối nội dung chú thích của bạn, đưa độc giả của bạn trở lại dòng chứa liên kết của chú thích.

Tôi không thể làm cho các giải pháp của Surya và Matteo hoạt động. Ví dụ: "(# f1)" chỉ được hiển thị dưới dạng văn bản và không trở thành một liên kết. Tuy nhiên, giải pháp của họ đã đưa tôi đến giải pháp hơi khác nhau. (Tôi cũng định dạng chú thích và liên kết trở lại bản siêu âm gốc một chút khác nhau.)

Trong phần nội dung của văn bản:

Yadda yadda<a href="#note1" id="note1ref"><sup>1</sup></a>

Cuối tài liệu:

<a id="note1" href="#note1ref"><sup>1</sup></a>Here is the footnote text.

Nhấp vào siêu ký tự trong phần chú thích sẽ trả về siêu ký tự trong văn bản gốc.

Mặc dù tôi không biết nếu nó chính thức được ghi lại ở bất cứ đâu, bạn có thể ghi chú chân trang trong Github.

1. Đánh dấu vị trí bạn muốn chèn liên kết chân trang với một số được đặt trong dấu ngoặc vuông, IE [1]

2. Ở dưới cùng của bài đăng, tạo một tham chiếu của điểm đánh dấu được đánh số và theo sau là dấu hai chấm và liên kết, IE [1]: http://www.example.com/link1

Và một khi bạn xem trước nó, nó sẽ được hiển thị dưới dạng các liên kết được đánh số trong phần thân bài.

Đối với các ghi chú ngắn, việc cung cấp một phần tử neo với thuộc tính tiêu đề sẽ tạo ra một "tooltip".

<a title="Note text goes here."><sup>n</sup></a>

Mặt khác, đối với các ghi chú liên quan nhiều hơn, có vẻ như đặt cược tốt nhất của bạn đang duy trì các liên kết được đặt tên theo cách thủ công.

Điều này làm việc cho tôi:

blablabla [<sup>1</sup>](#1)blablabla

chú thích: tham chiếu đến blablabla <a class="anchor" id="1"></a>

Tôi đã sử dụng một biến thể của giải pháp Mateo. Tôi đang sử dụng điều này trong các tệp Rmd ​​được viết bằng github có hương vị github (gfm) cho một trang web được hỗ trợ Jekyll nhưng các tệp Rmd ​​tương tự đang được sử dụng để tạo pdf trong các ngữ cảnh khác nhau. Các tệp Rmd ​​nặng về toán học và toán học được hiển thị với MathJax trên trang web. Vì vậy, tôi cần một giải pháp hoạt động với gfm được xử lý thông qua Jekyll, hoạt động với pandoc-> pdflatex và tương thích với MathJax.

đoạn trích từ tệp Rmd ​​(là gfm)

Here is a paragraph with an footnote <span id="a1">[[1]](#f1)</span>.

Footnotes
=========

1. <span id="f1"></span> This is a footnote. [$\hookleftarrow$](#a1)

$\hookleftarrow$là latex, hoạt động với tôi vì tôi luôn bật MathJax. Tôi sử dụng nó để đảm bảo nó hiển thị chính xác trong pdf của tôi. Tôi đặt chú thích của mình trong ngoặc vuông vì siêu ký tự gây nhầm lẫn nếu tôi đặt chú thích cho một số phép toán nội tuyến.

Đây là hoạt động: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

Những ghi chú có thể được đặt ở bất cứ đâu trong Rmd. Tôi đang đưa vào một danh sách ở cuối để chúng là những chú thích về mặt kỹ thuật.

Dưới đây là một biến thể của Eli Holmes ' câu trả lời mà làm việc cho tôi mà không sử dụng mủ:

Text<span id="a1">[¹](#1)</span>

<span id="1">¹</span> Footnote.[⏎](#a1)<br>

Thí dụ

Mặc dù câu hỏi là về Markdown có hương vị GitHub, tôi nghĩ rằng điều đáng nói là vào năm 2013 , GitHub hỗ trợ AsciiDoc có tính năng tích hợp sẵn này. Bạn chỉ cần đổi tên tệp của mình bằng một .adocphần mở rộng và sử dụng:

A statement.footnote:[Clarification about this statement.]

A bold statement!footnote:disclaimer[Opinions are my own.]

Another bold statement.footnote:disclaimer[]

Tài liệu cùng với kết quả cuối cùng là ở đây .