我只是想在我的GitHub Gist中添加脚注,但它不起作用:

Some long sentence. [^footnote]

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

我遵循这个指南,我不认为我做错了什么。有人能指出我的错误吗?


当前回答

虽然我不知道它是否在任何地方被正式记录,但你可以在Github中做脚注。

在想要插入页脚链接的地方用方括号括起来的数字标记出来,即[1] 在文章的底部,引用编号标记,后跟冒号和链接,即[1]:http://www.example.com/link1

一旦你预览它,它将呈现为编号的链接在文章的主体。

其他回答

对于简短的注释,提供带有标题属性的锚元素会创建一个“工具提示”。

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

否则,对于更复杂的注释,最好的方法似乎是手动维护命名链接。

虽然我不知道它是否在任何地方被正式记录,但你可以在Github中做脚注。

在想要插入页脚链接的地方用方括号括起来的数字标记出来,即[1] 在文章的底部,引用编号标记,后跟冒号和链接,即[1]:http://www.example.com/link1

一旦你预览它,它将呈现为编号的链接在文章的主体。

虽然这个问题是关于GitHub风格的Markdown,但我认为值得一提的是,截至2013年,GitHub支持内置该功能的AsciiDoc。你只需要用.adoc扩展名重命名你的文件,并使用:

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

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

Another bold statement.footnote:disclaimer[]

文档和最终结果在这里。

进一步扩展前面的答案,你可以在脚注的链接中添加id属性:

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

然后从脚注中链接回它。

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

这将在脚注内容的末尾添加一点篇幅,将读者带回到包含脚注链接的行。

我无法让Surya和Matteo的解决方案奏效。例如,“(#f1)”只是作为文本显示,而没有成为链接。然而,他们的解决方案使我得到了略有不同的解决方案。(我对脚注和回到原始上标的链接的格式也略有不同。)

在正文中:

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

在文件的最后:

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

单击脚注中的上标将返回原始文本中的上标。