webentwicklung-frage-antwort-db.com.de

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

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

Some long sentence. [^footnote]

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

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

224
Enrico Susatyo

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

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

178
Chris

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

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

Verweisen Sie dann wie folgt auf eine andere Stelle im Dokument

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

Um die vorherigen Antworten noch weiter zu erweitern, können Sie dem Link Ihrer Fußnote ein id -Attribut hinzufügen:

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

Verlinken Sie dann innerhalb der Fußnote wieder darauf.

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

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

149
Matteo

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

  1. Markieren Sie die Stelle, an der Sie den Footer-Link einfügen möchten, mit einer Zahl in eckigen Klammern, z. [1]

  2. Machen Sie am unteren Rand des Beitrags einen Verweis auf die nummerierte Markierung, gefolgt von einem Doppelpunkt und dem Link, I.E. [1]: http://www.example.com/link1

Und sobald Sie eine Vorschau anzeigen, werden sie als nummerierte Links im Hauptteil des Posts gerendert.

11
Devy

Ich war nicht in der Lage, die Lösungen von Surya und Matteo zum Laufen zu bringen. Beispiel: "(# f1)" wurde nur als Text angezeigt und ist kein Link geworden. 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 Hauptteil des Textes:

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.

Durch Klicken auf den hochgestellten Text in der Fußnote kehren Sie zum hochgestellten Text im Originaltext zurück.

7
Mars

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.

6
Rich Traube

Ich habe eine Variante von Mateos Lösung verwendet. Ich verwende dies in Rmd-Dateien, die mit Github-Flavored Markdown (GFM) für eine Jekyll-Website geschrieben wurden, aber die gleichen 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. Also brauchte ich eine Lösung, die mit gfm funktioniert, die über Jekyll verarbeitet wird, mit pandoc-> pdflatex funktioniert und mit MathJax kompatibel ist.

schnipsel 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 bei mir funktioniert, da ich MathJax immer aktiviert habe. Ich benutze das, um sicherzustellen, dass es in meinen PDFs richtig angezeigt wird. Ich setze meine Fußnoten in eckige Klammern, weil die Hochstellung verwirrend ist, wenn ich eine Fußnote in eine Inline-Mathematik setze.

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 RD abgelegt werden. Ich füge am Ende eine Liste ein, damit es sich um technische Endnoten handelt.

3
Eli Holmes

Das funktioniert bei mir:

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

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

2
aerijman