Jak dodać przypisy do Markdown o smaku GitHub?

Próbuję tylko dodać przypisy do mojej GitHub Gist , ale to nie działa:

Some long sentence. [^footnote]

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

Postępuję zgodnie z tym przewodnikiem i nie sądzę, że robię coś złego. Czy ktoś może wskazać mój błąd?

GitHub Flavored Markdown nie obsługuje przypisów, ale możesz ręcznie sfałszować go¹ ze znakami Unicode lub znacznikami górnymi, np <sup>1</sup>.

¹ Oczywiście nie jest to idealne rozwiązanie, ponieważ jesteś teraz odpowiedzialny za utrzymanie numeracji przypisów. Działa to dość dobrze, jeśli masz tylko jeden lub dwa.

Rozwijając nieco poprzednią odpowiedź, możesz również kliknąć linki przypisu tutaj. Najpierw zdefiniuj przypis u dołu w ten sposób

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

Następnie odwołaj się do tego w innym miejscu tego dokumentu

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

Rozszerzając poprzednie odpowiedzi jeszcze bardziej, możesz dodać idatrybut do linku przypisu:

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

Następnie w przypisie, z powrotem do niego link.

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

To doda trochę ↩na końcu treści przypisu, co zabierze czytelników z powrotem do wiersza zawierającego link przypisu.

Nie udało mi się uruchomić rozwiązań Suryi i Matteo. Na przykład „(# f1)” został po prostu wyświetlony jako tekst i nie stał się linkiem. Jednak ich rozwiązania doprowadziły mnie do nieco innego rozwiązania. (Również sformatowałem przypis i link z powrotem do oryginalnego indeksu górnego nieco inaczej).

W treści tekstu:

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

Na końcu dokumentu:

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

Kliknięcie indeksu górnego w przypisie powoduje powrót do indeksu górnego w oryginalnym tekście.

Chociaż nie wiem, czy jest to gdziekolwiek oficjalnie udokumentowane, możesz robić notatki w stopce w Github.

1. Zaznacz miejsce, w którym chcesz wstawić link stopki, liczbą zawartą w nawiasach kwadratowych, IE [1]

2. W dolnej części postu zrób odniesienie do ponumerowanego znacznika, a następnie dwukropka i łącza, IE [1]: http://www.example.com/link1

A kiedy go wyświetlisz, będzie renderowany jako numerowane linki w treści postu.

W przypadku krótkich notatek podanie elementu kotwicy z atrybutem tytułu tworzy „etykietkę narzędzia”.

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

W przeciwnym razie, dla bardziej zaangażowanych notatek, wygląda na to, że najlepszym rozwiązaniem jest ręczne utrzymywanie nazwanych linków.

To działa dla mnie:

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

przypisy: odniesienie do blablabla <a class="anchor" id="1"></a>

Użyłem wariantu rozwiązania Mateo. Używam tego w plikach Rmd zapisanych w github flavored markdown (gfm) dla witryny opartej na Jekyll, ale te same pliki Rmd są używane do tworzenia plików PDF w różnych kontekstach. Pliki Rmd są ciężkie z matematyki, a matematyka jest wyświetlana w MathJax na stronie internetowej. Potrzebowałem więc rozwiązania współpracującego z gfm, które jest przetwarzane przez Jekyll, działa z pandoc-> pdflatex i jest kompatybilne z MathJax.

snippet z pliku Rmd (którym jest 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$to lateks, który działa dla mnie, ponieważ zawsze mam włączony MathJax. Używam tego, aby upewnić się, że poprawnie wyświetla się w moich plikach pdf. Umieszczam swoje przypisy w nawiasach kwadratowych, ponieważ indeks górny jest mylący, jeśli umieszczam przypis w matematyce wbudowanej.

Tutaj jest w akcji: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

Te notatki można umieścić w dowolnym miejscu w Rmd. Na końcu umieszczam listę, aby były to technicznie przypisy końcowe.

Oto wariacja Eli Holmesa ' odpowiedź , że pracował dla mnie bez użycia lateksu:

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

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

Przykład

Chociaż pytanie dotyczy Markdown o smaku GitHub, myślę, że warto wspomnieć, że od 2013 roku GitHub obsługuje AsciiDoc, który ma tę wbudowaną funkcję. Musisz tylko zmienić nazwę pliku z .adocrozszerzeniem i użyć:

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

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

Another bold statement.footnote:disclaimer[]

Dokumentacja wraz z wynikiem końcowym znajduje się tutaj .