Como adicionar notas de rodapé ao Markdown com sabor do GitHub?

Estou apenas tentando adicionar notas de rodapé no meu GitHub Gist , mas não funciona:

Some long sentence. [^footnote]

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

Estou seguindo este guia e acho que não estou fazendo nada de errado. Alguém pode apontar o meu erro?

O Markdown com sabor do GitHub não suporta notas de rodapé, mas você pode falsificá-lo manualmente¹ com caracteres Unicode ou tags sobrescritas, por exemplo <sup>1</sup>.

CourseClaro que isso não é o ideal, pois agora você é responsável por manter a numeração das notas de rodapé. Funciona razoavelmente bem se você tiver apenas um ou dois.

Expandindo um pouco a resposta anterior, você também pode clicar nos links das notas de rodapé aqui. Primeiro defina a nota de rodapé na parte inferior como esta

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

Em seguida, referencie-o em algum outro local do documento como este

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

Expandindo ainda mais as respostas anteriores, você pode adicionar um idatributo ao link da nota de rodapé:

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

Em seguida, de dentro da nota de rodapé, vincule-o novamente.

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

Isso adicionará um pouco ↩ao final do conteúdo da nota de rodapé, o que levará seus leitores de volta à linha que contém o link da nota de rodapé.

Não consegui que as soluções de Surya e Matteo funcionassem. Por exemplo, "(# f1)" foi exibido apenas como texto e não se tornou um link. No entanto, suas soluções me levaram a uma solução ligeiramente diferente. (Também formatei a nota de rodapé e o link de volta ao sobrescrito original de maneira um pouco diferente.)

No corpo do texto:

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

No final do documento:

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

Clicar no sobrescrito na nota de rodapé retorna ao sobrescrito no texto original.

Embora eu não saiba se está oficialmente documentado em algum lugar, você pode fazer anotações no rodapé no Github.

1. Marque o local em que deseja inserir o link do rodapé com um número entre colchetes, IE [1]

2. Na parte inferior da postagem, faça uma referência ao marcador numerado e seguido por dois pontos e o link, IE [1]: http://www.example.com/link1

E depois de visualizá-lo, ele será renderizado como links numerados no corpo da postagem.

Para anotações curtas, fornecer um elemento âncora com um atributo title cria uma "dica de ferramenta".

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

Caso contrário, para notas mais envolvidas, parece que sua melhor aposta é manter os links nomeados manualmente.

Isso funciona para mim:

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

notas de rodapé: referência a blablabla <a class="anchor" id="1"></a>

Eu usei uma variante da solução de Mateo. Eu estou usando isso em arquivos Rmd escritos em github flavored markdown (gfm) para um site movido a Jekyll, mas os mesmos arquivos Rmd estão sendo usados ​​para produzir pdfs em vários contextos. Os arquivos Rmd são pesados ​​em matemática e a matemática é exibida com o MathJax no site. Então, eu precisava de uma solução que funcione com o gfm que seja processada via Jekyll, que funcione com o pandoc-> pdflatex e que seja compatível com o MathJax.

trecho do arquivo Rmd (que é 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$é látex, o que funciona para mim, pois sempre tenho o MathJax ativado. Eu uso isso para garantir que ele apareça corretamente nos meus PDFs. Coloco minhas notas de rodapé entre colchetes porque o sobrescrito é confuso se eu estiver colocando uma nota de rodapé em alguma matemática embutida.

Aqui está em ação: https://eeholmes.github.io/posts/2016-5-18-FI-recursion-1/

Essas notas podem ser colocadas em qualquer lugar no Rmd. Estou colocando uma lista no final para que sejam notas técnicas.

Aqui está uma variação de Eli Holmes ' resposta que funcionou para mim sem o uso de látex:

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

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

Exemplo

Embora a pergunta seja sobre o Markdown com sabor do GitHub, acho que vale a pena mencionar que, a partir de 2013 , o GitHub suporta o AsciiDoc, que tem esse recurso embutido. Você só precisa renomear seu arquivo com uma .adocextensão e usar:

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

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

Another bold statement.footnote:disclaimer[]

A documentação e o resultado final estão aqui .