Wie füge ich Fußnoten zu Markdown mit GitHub-Geschmack hinzu?

Ich versuche nur, Fußnoten in meinen GitHub Gist einzufügen , aber es funktioniert nicht:

Some long sentence. [^footnote]

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

Ich folge dieser Anleitung und glaube nicht, dass ich etwas falsch mache. Kann jemand auf meinen Fehler hinweisen?

GitHub Flavored Markdown unterstützt keine Fußnoten, aber Sie können es manuell mit Unicode-Zeichen oder hochgestellten Tags fälschen, z <sup>1</sup>.

¹Natürlich ist dies nicht ideal, da Sie jetzt dafür verantwortlich sind, die Nummerierung Ihrer Fußnoten beizubehalten. Es funktioniert jedoch ziemlich gut, wenn Sie nur ein oder zwei haben.

Wenn Sie die vorherige Antwort ein wenig erweitern, können Sie die Fußnoten-Links auch hier anklickbar machen. Definieren Sie zuerst die Fußnote unten wie folgt

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

Verweisen Sie dann an einer anderen Stelle im Dokument wie folgt darauf

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

Wenn Sie die vorherigen Antworten noch weiter erweitern, können idSie dem Link Ihrer Fußnote ein Attribut hinzufügen :

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

Verknüpfen Sie dann innerhalb der Fußnote wieder damit.

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

Dies fügt ↩am Ende des Inhalts Ihrer Fußnote ein wenig hinzu , wodurch Ihre Leser zu der Zeile zurückkehren, die den Link der Fußnote enthält.

Ich war nicht in der Lage, die Lösungen von Surya und Matteo zum Laufen zu bringen. Zum Beispiel wurde "(# f1)" nur als Text angezeigt und wurde nicht zu einem Link. Ihre Lösungen führten mich jedoch zu einer etwas anderen Lösung. (Ich habe auch die Fußnote und den Link zum hochgestellten Original etwas anders formatiert.)

Im Textkörper:

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

Am Ende des Dokuments:

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

Wenn Sie in der Fußnote auf den hochgestellten Index klicken, kehren Sie zum hochgestellten Text im Originaltext zurück.

Obwohl mir nicht bekannt ist, ob es irgendwo offiziell dokumentiert ist, können Sie in Github Fußzeilennotizen machen.

1. Markieren Sie die Stelle, an der Sie den Fußzeilenlink einfügen möchten, mit einer Zahl in eckigen Klammern (IE) [1]

2. Verweisen Sie am Ende des Beitrags auf den nummerierten Marker, gefolgt von einem Doppelpunkt und dem Link IE [1]: http://www.example.com/link1

Sobald Sie eine Vorschau anzeigen, wird es als nummerierter Link im Hauptteil des Beitrags gerendert.

Wenn Sie für kurze Notizen ein Ankerelement mit einem title-Attribut versehen, wird ein "Tooltip" erstellt.

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

Andernfalls scheint es für komplexere Notizen am besten zu sein, benannte Links manuell zu pflegen.

Das funktioniert bei mir:

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

Fußnoten: Verweis auf blablabla <a class="anchor" id="1"></a>

Ich habe eine Variante von Mateos Lösung verwendet. Ich verwende dies in Rmd-Dateien, die in Github Flavoured Markdown (gfm) für eine Jekyll-basierte Website geschrieben wurden, aber dieselben Rmd-Dateien werden verwendet, um PDFs in verschiedenen Kontexten zu erstellen. Die Rmd-Dateien sind mathematisch schwer und die Mathematik wird mit MathJax auf der Website angezeigt. Ich brauchte also eine Lösung, die mit gfm funktioniert, die über Jekyll verarbeitet wird, mit pandoc-> pdflatex funktioniert und mit MathJax kompatibel ist.

Ausschnitt aus der Rmd-Datei (die gfm ist)

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$ist Latex, was für mich funktioniert, da ich MathJax immer aktiviert habe. Ich benutze das, um sicherzustellen, dass es in meinen PDFs korrekt angezeigt wird. Ich setze meine Fußnoten in eckige Klammern, weil hochgestellt verwirrend ist, wenn ich eine Fußnote zu einer Inline-Mathematik schreibe.

Hier ist es in Aktion: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

Diese Notizen können an einer beliebigen Stelle im RMD abgelegt werden. Ich füge am Ende eine Liste ein, damit es sich technisch gesehen um Endnoten handelt.

Hier ist eine Variation von Eli Holmes ' Antwort , die für mich ohne Latex funktioniert hat:

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

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

Beispiel

Obwohl es sich bei der Frage um Markdown mit GitHub-Geschmack handelt, sollte erwähnt werden, dass GitHub ab 2013 AsciiDoc unterstützt, in das diese Funktion integriert ist. Sie müssen Ihre Datei nur mit einer .adocErweiterung umbenennen und verwenden:

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

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

Another bold statement.footnote:disclaimer[]

Die Dokumentation zusammen mit dem Endergebnis finden Sie hier .