Markdown和脚注：最自然的格式缺失？

Question

Markdown和脚注：最自然的格式缺失？

16

到目前为止的Markdown和脚注

我参考了daringfireball.net上的Markdown：Syntax，这似乎是Markdown语法的主要来源。

Markdown已知是基于邮件和新闻组中已有的格式。在邮件和新闻组中，我经常看到类似于以下内容的脚注和转发引用：

Blah, blah [1] blah, blah.

[1] http://somesite.com/somepage.html#someanchor

令人惊讶的是，这种非常常见的格式并不是主要 Markdown 参考资料的一部分。它只知道类似于：

Blah, blah [some title][id] blah, blah.

[id]: http://somesite.com/somepage.html#someanchor

我从未在新闻组或邮件列表中看到有人自发使用此功能，而前者非常普遍。

我只能找到一个叫做PHP Markdown Extra的东西，它更接近于常见的自发用法，但仍然有所不同：

Blah, blah [^id] blah, blah.

[id]: http://somesite.com/somepage.html#someanchor

更接近了，但我仍然没有看到有人在新闻组或邮件中使用它。

问题

我想知道为什么这种如此常见的用法不是主要markdown参考的一部分，甚至不是我所知道的任何变体的一部分。如果有人知道这个原因，我很感兴趣知道这个原因。另一方面，如果我只是错过了什么，比如错过了一个非常常见的markdown变体，其中包括编写脚注或转发引用的实际上最自然的方式（在本帖中介绍的第一个方法），那么我想知道它。

- Hibou57

2个回答

6

除了您提到的Php Markdown Extra之外，还有一些Markdown变体或“口味”实现了脚注。我知道的这些是Pandoc's Markdown, R Markdown, ScholarlyMarkdown, 和 MultiMarkdown。

我相信在所有这些变体中，脚注的工作方式都是这样的：

这是一些带有脚注的文本。 [^] 还有另一个。 [^]

[^]: 这是第一个脚注。
[^]: 这是第二个脚注。

或者内联形式：

这是一些带有脚注的文本。^[这是第一个脚注。] 还有另一个 ^[这是第二个脚注。]

它们应该都呈现为这样：

这是一些带有脚注的文本。¹还有一个。²

这是第一个脚注。↩

这是第二个脚注。↩

您也可以在脚注中添加链接，例如：

这是一些带有脚注和链接的文本。[^这里是一个带有链接的脚注示例。 [link](http://stackoverflow.com)]

应该呈现为：

这是一些带有脚注的文本。¹

这是一个带有链接的脚注示例。link ↩

顺便说一下，如果您使用像Atom或VSCode这样的编辑器，您可能需要添加扩展Markdown Preview Enhanced。正如名称所示，它允许在输入时预览渲染后的文本（它支持Pandoc的预览和导出）。

Pandoc有关此事的文档：https://pandoc.org/MANUAL.html#footnotes

- nunop

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- jww · Accepted Answer

“为什么一个如此常见的用法不是主要的Markdown参考，甚至不是我所知道的任何变体的一部分。”

“看起来有些内容可以在使用Markdown或HTML格式化帖子的方法中找到：”

“链接”

Here's an inline link to [Google](http://www.google.com/). Here's a
reference-style link to [Google][1]. Here's a very readable link to
[Yahoo!][yahoo].

  [1]: http://www.google.com
  [yahoo]: http://www.yahoo.com/

高级链接

链接可以拥有一个标题属性，在悬停时会显示出来。也可以添加标题属性；如果链接本身不足以描述用户将要去的地方，这些属性是非常有帮助的。

Here's a [poorly-named link](http://www.google.com/ "Google").
Never write "[click here][^2]".
Visit [us][web].

  [^2]: http://www.w3.org/QA/Tips/noClickHere
        (Advice against the phrase "click here")
  [web]: http://programmers.stackexchange.com/ "Programmers Stack Exchange"

还可以在 Meta 上看到 Markdown 脚注？。该页面提到了 Markdown With Footnotes。