markdown - 如何更有效地将脚注插入 Hexo 帖子中？

Question

我一直在尝试在我的 Hexo 帖子中插入脚注(用 Markdown 编写，如果他们的标记语言相关的话)。我有使用 Jekyll 来支持我的网站的背景，当我使用 Jekyll 时，我会添加 [^n] (其中 n 是正整数，即 n ∈ {1,2,3, ...})在文本中，例如:

[^1]: footnote #1
[^2]: footnote #2
[^3]: footnote #3
...

在帖子末尾，footnote #1、#2、#3、等替换为我的实际脚注。而使用 Hexo 时，事情似乎有点复杂。我在 https://hexo.io/plugins/ 寻找脚注插件，不成功的话我可能会补充，然后我用Google搜索答案，发现了这个要点https://gist.github.com/kuanyui/d1728c2a526a615de56c 。我尝试将这个要点添加到我的 Hexo 站点的 script 文件夹中，但是失败了(有关完整的错误详细信息，请参阅要点，因为我在那里评论了详细信息)。然后，我尝试了通过检查 Jekyll 帖子的生成内容(通过上述方法添加了脚注)学到的 HTML 技巧。即添加:

<sup id="fnref:n"><a href="#fn:n" class="footnote">n</a></sup>

(其中 n 再次是正整数)在我希望出现脚注的文本中:

<ol>
  <li id="fn:1">Footnote #1.<a href="#fnref:1" class="reversefootnote">↩</a></li>
  <li id="fn:2">Footnote #2.<a href="#fnref:2" class="reversefootnote">↩</a></li>
  <li id="fn:3">Footnote #3.<a href="#fnref:3" class="reversefootnote">↩</a></li>
  ...
</ol>

到帖子末尾。问题是，这种方法虽然有效，但也很乏味(即，每个脚注需要比我想要的更多的输入)，所以我尝试创建这个 ejs 模板(对应于文本脚注)，我放置在我的 layouts 文件夹中，名为 footnotes.ejs:

<sup id ="fnref:<%= n %>"><a href="#fn:<%= n %>"><%= n %></a></sup>

并将其插入到我的帖子中:

<%- include('layouts/footnotes', {n:1}); %>

但这也失败了(失败是指当我生成 hexo 网站时，文本内的引用完全没有格式化)。

所以我来这里是为了寻求一种更有效的方法来在 Hexo 帖子中插入脚注。即每个脚注都需要尽可能少的打字。

Answer 1

我刚刚创建了一个 hexo 插件来支持 markdown 脚注:

• Github repository
• NPM package

因此，您只需使用

安装该软件包即可

npm install hexo-footnotes --save

如果 Hexo 自动检测所有插件，仅此而已。

如果情况并非如此，请在您的 _config.yml 文件中注册插件:

plugins:
  - hexo-footnotes

语法如下:

basic footnote[^1]
here is an inline footnote[^2](inline footnote)
and another one[^3]
and another one[^4]

[^1]: basic footnote content
[^3]: paragraph
footnote
content
[^4]: footnote content with some [markdown](https://en.wikipedia.org/wiki/Markdown)

这是结果: