online - markdown tutorial
¿Cómo agregar notas al pie a Markdown con sabor a GitHub? (7)
Solo intento añadir 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 algo mal. ¿Alguien puede señalar mi error?
Ampliando aún más las respuestas anteriores, puede agregar un atributo de id
al enlace de su nota al pie:
Bla bla <sup id="a1">[1](#f1)</sup>
Luego, desde dentro de la nota al pie, enlace de regreso a ella.
<b id="f1">1</b> Footnote content here. [↩](#a1)
Esto agregará un poco ↩
al final del contenido de su nota al pie, que lleva a sus lectores a la línea que contiene el enlace de la nota al pie.
Ampliando un poco en la respuesta anterior, puede hacer que los enlaces de la nota al pie se puedan hacer clic aquí también. Primero defina la nota al pie en la parte inferior como esta
<a name="myfootnote1">1</a>: Footnote content goes here
Luego haz referencia en algún otro lugar del documento como este
<sup>[1](#myfootnote1)</sup>
Aunque no estoy al tanto de si está oficialmente documentado en alguna parte, puede hacer notas al pie de página en Github.
Marque el lugar donde desea insertar el enlace de pie de página con un número entre corchetes, IE
[1]
En la parte inferior de la publicación, haz una referencia del marcador numerado seguido de dos puntos y el enlace, IE
[1]: http://www.example.com/link1
Y una vez que lo previsualice, se representará como enlaces numerados en el cuerpo de la publicación.
GitHub Flavoured Markdown no admite notas a pie de página, pero puede falsificarlo manualmente con caracteres Unicode o etiquetas de superíndices, por ejemplo, <sup>1</sup>
.
¹ Por supuesto, esto no es lo ideal, ya que ahora es responsable de mantener la numeración de sus notas al pie. Sin embargo, funciona razonablemente bien si solo tienes uno o dos.
No pude hacer funcionar las soluciones de Surya y Matteo. Por ejemplo, "(# f1)" solo se muestra como texto y no se convirtió en un enlace. Sin embargo, sus soluciones me llevaron a una solución ligeramente diferente. (También he formateado la nota al pie y el enlace de vuelta 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 vuelve al superíndice en el texto original.
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 notas más complicadas, parece que su mejor opción es mantener enlaces nombrados manualmente.
Usé una variante de la solución de Mateo. Estoy usando esto en archivos Rmd escritos en github con sabor rebajado (gfm) para un sitio web potenciado por 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 las matemáticas se muestran con MathJax en el sitio web. Así que necesitaba una solución que funciona con gfm que se procesa a través de Jekyll, funciona con pandoc-> pdflatex y es compatible con MathJax.
fragmento de 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 latex, que funciona para mí ya que siempre tengo MathJax habilitado. Lo uso para asegurarme de que se muestra correctamente en mis pdfs. Puse mis notas al pie entre corchetes porque el superíndice es confuso si estoy poniendo 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 pueden colocarse en cualquier lugar de la Rmd. Estoy poniendo una lista al final, así que técnicamente son notas al final.