16

到目前为止的 Markdown 和脚注

我指的是Markdown: Syntax at daringfireball.net，它似乎是 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 变体，并且包括在实践中最自然的编写脚注或转发参考的方式（本文介绍的第一个），那么我会想知道它。

4

2 回答 2

8

...为什么这么多常见的用法不是主要降价参考的一部分，甚至不是我所知道的任何变体的一部分。

看起来其中一些可用如何使用 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/

高级链接

链接可以有一个标题属性，它会在悬停时显示。也可以添加title属性；如果链接本身的描述性不足以告诉用户他们要去哪里，它们会很有帮助。

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"

另请参阅Markdown 脚注？在元。该页面提到了带有脚注的 Markdown。

于 2014-01-24T02:39:33.267 回答
5

有一些 Markdown 变体或“风味”可以实现脚注（除了你提到的Php Markdown Extra）。我知道的是Pandoc 的 Markdown、R Markdown、ScholarlyMarkdown和MultiMarkdown。

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

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

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

或内联：

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

他们都应该以这种方式呈现：

这是一些带脚注的文本。1还有一个。2

  1. 这是第一个脚注。↩</li>
  2. 这是第二个脚注。↩</li>

您也可以将链接添加到脚注，例如：

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

应该像这样呈现：

这是一些带脚注的文本。1

  1. 这是一个脚注示例，末尾有一个链接。链接↩</li>

顺便说一句，如果您使用Atom或VSCode等编辑器，您可能需要添加扩展Markdown Preview Enhanced。顾名思义，它允许在您键入时预览呈现的文本（它支持使用 Pandoc 进行预览和导出）。

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

于 2017-12-12T00:47:59.247 回答