Comment ajouter des notes de bas de page à Markdown aromatisé GitHub?

J'essaie simplement d'ajouter des notes de bas de page dans mon GitHub Gist , mais cela ne fonctionne pas:

Some long sentence. [^footnote]

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

Je suis ce guide et je ne pense pas que je fais quelque chose de mal. Quelqu'un peut-il signaler mon erreur?

GitHub Flavoured Markdown ne prend pas en charge les notes de bas de page, mais vous pouvez le simuler manuellement¹ avec des caractères Unicode ou des balises en exposant, par exemple <sup>1</sup>.

¹ Bien sûr, ce n'est pas idéal, car vous êtes maintenant responsable du maintien de la numérotation de vos notes de bas de page. Cela fonctionne assez bien si vous n'en avez qu'un ou deux, cependant.

En développant un peu la réponse précédente, vous pouvez également rendre les liens de note de bas de page cliquables ici. Définissez d'abord la note de bas de page comme ceci

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

Puis référencez-le à un autre endroit dans le document comme celui-ci

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

En développant les réponses précédentes encore plus loin, vous pouvez ajouter un idattribut au lien de votre note de bas de page:

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

Ensuite, dans la note de bas de page, liez-la à nouveau.

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

Cela ajoutera un peu ↩à la fin du contenu de votre note de bas de page, ce qui ramènera vos lecteurs à la ligne contenant le lien de la note de bas de page.

Je n'ai pas réussi à faire fonctionner les solutions de Surya et Matteo. Par exemple, "(# f1)" était simplement affiché sous forme de texte et n'est pas devenu un lien. Cependant, leurs solutions m'ont conduit à une solution légèrement différente. (J'ai également formaté la note de bas de page et le lien vers l'exposant d'origine un peu différemment.)

Dans le corps du texte:

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

A la fin du document:

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

Cliquer sur l'exposant dans la note de bas de page revient à l'exposant dans le texte original.

Bien que je ne sache pas si c'est officiellement documenté quelque part, vous pouvez faire des notes de bas de page dans Github.

1. Marquez l'endroit où vous souhaitez insérer le lien de pied de page avec un nombre entre crochets, IE [1]

2. Au bas du message, faites une référence au marqueur numéroté et suivi d'un deux-points et du lien, IE [1]: http://www.example.com/link1

Et une fois que vous l'avez prévisualisé, il sera rendu sous forme de liens numérotés dans le corps du message.

Pour les notes courtes, fournir un élément d'ancrage avec un attribut title crée une "info-bulle".

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

Sinon, pour les notes plus impliquées, il semble que votre meilleur pari est de maintenir manuellement les liens nommés.

Cela fonctionne pour moi:

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

notes de bas de page: référence à blablabla <a class="anchor" id="1"></a>

J'ai utilisé une variante de la solution de Mateo. J'utilise ceci dans des fichiers Rmd écrits dans un démarquage aromatisé github (gfm) pour un site Web propulsé par Jekyll, mais les mêmes fichiers Rmd sont utilisés pour produire des fichiers PDF dans divers contextes. Les fichiers Rmd sont lourds en mathématiques et les mathématiques sont affichées avec MathJax sur le site Web. J'avais donc besoin d'une solution qui fonctionne avec gfm qui est traitée via Jekyll, fonctionne avec pandoc-> pdflatex et est compatible avec MathJax.

extrait de fichier Rmd (qui est 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$est le latex, qui fonctionne pour moi car j'ai toujours MathJax activé. J'utilise cela pour m'assurer qu'il s'affiche correctement dans mes fichiers PDF. Je mets mes notes de bas de page entre crochets parce que l'exposant est déroutant si je mets une note de bas de page sur des mathématiques en ligne.

Le voici en action: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

Ces notes peuvent être placées n'importe où dans le Rmd. Je mets une liste à la fin, donc ce sont techniquement des notes de fin.

Voici une variante de la réponse d' Eli Holmes qui a fonctionné pour moi sans utiliser de latex:

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

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

Exemple

Bien que la question concerne le Markdown aromatisé GitHub, je pense qu'il convient de mentionner qu'à partir de 2013 , GitHub prend en charge AsciiDoc qui intègre cette fonctionnalité. Il vous suffit de renommer votre fichier avec une .adocextension et d'utiliser:

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

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

Another bold statement.footnote:disclaimer[]

La documentation avec le résultat final est ici .