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?
markdown
github-flavored-markdown
multimarkdown
Enrico Susatyo
quelle
quelle
[^footnote]
Syntax, noch bevor sie offiziell in die Dokumentation aufgenommen wurdeAntworten:
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.
quelle
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
Verweisen Sie dann an einer anderen Stelle im Dokument wie folgt darauf
quelle
Example [[TPL]](#TPL)
...#### Notes
...<a name="TPL">[TPL]</a> footnote template
Wenn Sie die vorherigen Antworten noch weiter erweitern, können
id
Sie dem Link Ihrer Fußnote ein Attribut hinzufügen :Verknüpfen Sie dann innerhalb der Fußnote wieder damit.
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.quelle
name
anstelle desid
Aufrufs der Fußnote verwenden.Bla bla <sup name="a1">[1](#f1)</sup>
name
undid
für README-Dateien auf github.com funktionieren.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:
Am Ende des Dokuments:
Wenn Sie in der Fußnote auf den hochgestellten Index klicken, kehren Sie zum hochgestellten Text im Originaltext zurück.
quelle
Obwohl mir nicht bekannt ist, ob es irgendwo offiziell dokumentiert ist, können Sie in Github Fußzeilennotizen machen.
Markieren Sie die Stelle, an der Sie den Fußzeilenlink einfügen möchten, mit einer Zahl in eckigen Klammern (IE)
[1]
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.
quelle
#1
funktionierte nicht als Link zum Github-Markdown (Dezember 2018).Wenn Sie für kurze Notizen ein Ankerelement mit einem title-Attribut versehen, wird ein "Tooltip" erstellt.
Andernfalls scheint es für komplexere Notizen am besten zu sein, benannte Links manuell zu pflegen.
quelle
Das funktioniert bei mir:
blablabla
[<sup>1</sup>](#1)
blablablaFußnoten: Verweis auf blablabla
<a class="anchor" id="1"></a>
quelle
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)
$\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.
quelle
Hier ist eine Variation von Eli Holmes ' Antwort , die für mich ohne Latex funktioniert hat:
Beispiel
quelle
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
.adoc
Erweiterung umbenennen und verwenden:Die Dokumentation zusammen mit dem Endergebnis finden Sie hier .
quelle