¿Cómo agregar notas al pie a Markit con sabor a GitHub?

Solo estoy tratando de agregar notas al pie en mi GitHub Gist , pero no funciona:

Some long sentence. [^footnote]

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

Estoy siguiendo esta guía y no creo que esté haciendo nada malo. ¿Alguien puede señalar mi error?

GitHub Flavored Markdown no admite notas al pie, pero puede falsificarlo manualmente manually con caracteres Unicode o etiquetas de superíndice, por ejemplo <sup>1</sup>.

¹Por supuesto, esto no es ideal, ya que ahora eres responsable de mantener la numeración de tus notas al pie. Sin embargo, funciona razonablemente bien si solo tiene uno o dos.

Ampliando un poco la respuesta anterior, también puede hacer clic en los enlaces de notas al pie aquí. Primero defina la nota al pie en la parte inferior de esta manera

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

Luego haga referencia a él en otro lugar del documento como este

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

Ampliando aún más las respuestas anteriores, puede agregar un idatributo al enlace de su nota al pie:

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

Luego, dentro de la nota al pie de página, vuelva a vincularla.

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

Esto agregará un poco ↩al final del contenido de su nota al pie, lo que lleva a sus lectores a la línea que contiene el enlace de la nota al pie.

No pude lograr que las soluciones de Surya y Matteo funcionen. Por ejemplo, "(# f1)" solo se mostró como texto y no se convirtió en un enlace. Sin embargo, sus soluciones me llevaron a una solución ligeramente diferente. (También formateé la nota al pie y el enlace al superíndice original de forma un poco diferente).

En el cuerpo del texto:

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

Al final del documento:

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

Al hacer clic en el superíndice en la nota al pie, se vuelve al superíndice en el texto original.

Aunque no sé si está documentado oficialmente en alguna parte, puedes hacer notas de pie de página en Github.

1. Marque el lugar donde desea insertar el enlace del pie de página con un número entre corchetes, IE [1]

2. En la parte inferior de la publicación, haga una referencia del marcador numerado y seguido de dos puntos y el enlace, IE [1]: http://www.example.com/link1

Y una vez que lo vea, se representará como enlaces numerados en el cuerpo de la publicación.

Para notas cortas, proporcionar un elemento de anclaje con un atributo de título crea una "información sobre herramientas".

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

De lo contrario, para las notas más involucradas, parece que su mejor opción es mantener los enlaces con nombre manualmente.

Esto funciona para mi:

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

notas al pie: referencia a blablabla <a class="anchor" id="1"></a>

Usé una variante de la solución de Mateo. Estoy usando esto en archivos Rmd escritos en Markdown con sabor a github (gfm) para un sitio web con tecnología Jekyll, pero los mismos archivos Rmd se están utilizando para producir archivos PDF en varios contextos. Los archivos Rmd son matemáticos pesados ​​y la matemática se muestra con MathJax en el sitio web. Así que necesitaba una solución que funcionara con gfm que se procesara a través de Jekyll, que funcionara con pandoc-> pdflatex y que sea compatible con MathJax.

fragmento del archivo Rmd (que es 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$es látex, que funciona para mí ya que siempre tengo habilitado MathJax Lo uso para asegurarme de que se muestre correctamente en mis archivos PDF. Pongo mis notas al pie entre corchetes porque el superíndice es confuso si pongo una nota al pie en algunas matemáticas en línea.

Aquí está en acción: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

Estas notas se pueden poner en cualquier lugar del Rmd. Estoy poniendo una lista al final para que sean técnicamente notas finales.

Aquí hay una variación de la respuesta de Eli Holmes que funcionó para mí sin usar látex:

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

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

Ejemplo

Aunque la pregunta es sobre Markdown con sabor a GitHub, creo que vale la pena mencionar que a partir de 2013 , GitHub es compatible con AsciiDoc, que tiene esta característica incorporada. Solo necesita cambiar el nombre de su archivo con una .adocextensión y usar:

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

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

Another bold statement.footnote:disclaimer[]

La documentación junto con el resultado final está aquí .