Hib*_*u57 14 markdown footnotes
我指的是Markdown: daringfireball.net上的语法,它似乎是Markdown语法的主要来源.
众所周知,Markdown基于邮件和新闻组中已有的格式.在邮件和新闻组中,我经常看到这样的内容用于脚注和转发引用:
Blah, blah [1] blah, blah.
[1] http://somesite.com/somepage.html#someanchor
Run Code Online (Sandbox Code Playgroud)
令人惊讶的是,这种非常常见的格式不是主要Markdown参考的一部分.它只知道如下:
Blah, blah [some title][id] blah, blah.
[id]: http://somesite.com/somepage.html#someanchor
Run Code Online (Sandbox Code Playgroud)
我从来没有在新闻组或邮件列表中看到任何使用过这种情况,而前者非常普遍.
我可以找到一种名为PHP Markdown Extra的东西,它有更接近常见的自发用法,但足够不同:
Blah, blah [^id] blah, blah.
[id]: http://somesite.com/somepage.html#someanchor
Run Code Online (Sandbox Code Playgroud)
更近,但我仍然没有看到有人在新闻组或邮件中使用它.
我想知道为什么这么多常见用法不是主要降价参考的一部分,甚至不是我所知道的任何变体的一部分.如果有人知道这个的原因,我很想知道这个原因.另一方面,如果我错过了一些东西,比如错过了一个非常常用的降价变体,并且在实践中包括了写脚注或转发参考的最自然方式(本文中介绍的第一个),那么我会喜欢知道它.
祝你有美好的一天.
...为什么如此常见的用法不是主要降价参考的一部分,甚至不是我所知道的任何变体的一部分.
它看起来有些是可用的如何使用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/
Run Code Online (Sandbox Code Playgroud)
高级链接
链接可以具有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"
Run Code Online (Sandbox Code Playgroud)
另请参阅Markdown脚注?在Meta.该页面提到Markdown With Footnotes.
有一些 Markdown 变体或“风味”可以实现脚注(除了您提到的Php Markdown Extra)。我所知道的是Pandoc 的 Markdown、R Markdown、ScholarlyMarkdown和MultiMarkdown。
我相信脚注在所有这些变体中都是这样工作的:
这是一些带有脚注的文本。[^] 另一个。[^]
[^]:这是第一个脚注。
[^]:这是第二个脚注。
或内联:
这是一些带有脚注的文本。^[这是第一个脚注。]另一个 ^[这是第二个脚注。]
他们都应该这样渲染:
这是一些带有脚注的文本。1还有一个。2
- 这是第一个脚注。?
- 这是第二个脚注。?
您也可以添加脚注链接,例如:
这是一些带有脚注和链接的文本。[^这是一个在末尾带有链接的脚注示例。[链接]( http://stackoverflow.com)]
应该像这样呈现:
这是一些带有脚注的文本。1
- 这是一个在末尾带有链接的脚注示例。链接?
顺便说一句,如果您使用Atom或VSCode等编辑器,您可能需要添加扩展Markdown Preview Enhanced。顾名思义,它允许在您键入时预览渲染的文本(它支持使用 Pandoc 进行预览和导出)。
Pandoc 关于此事的文档:https : //pandoc.org/MANUAL.html#footnotes
归档时间: |
|
查看次数: |
7073 次 |
最近记录: |