我最近转而在Github Pages上使用Jekyll为我的各种博客,并且喜欢我可以将Markdown推送到Github并且他们处理这些处理。我想继续以这种方式使用它(而不是在本地运行Jekyll,只是将预先生成的站点推送到Github),因为如果我不在自己的机器上,Github UI可以轻松添加和调整帖子。
只有一件事我无法弄明白:我无法让Markdown脚注工作。我正在使用这种风格:
I bet you'd like more information about this sentence [^1].
[^1]: Well lucky for you, I've included more information in footnote form.
我确实找到一个帖子(某个地方)建议为redcarpet降价处理器启用脚注扩展,但这也不是这样做的:
markdown: redcarpet
redcarpet:
extensions: ["footnotes"]
在将静态网站推送到Github之前,有没有办法使用Markdown脚注而不预先生成静态网站?
答案 0 :(得分:58)
我使用kramdown进行降价解析,它可以很好地处理脚注。
在_config.yml
文件中更改此行:
markdown: redcarpet
为:
markdown: kramdown
答案 1 :(得分:13)
截至Jekyll 3.0.0,kramdown is the default Markdown processor,因此OP问题中的示例现在开箱即用。模式是:
Some text[^1].
Some other text[^2].
The identifier in the square brackets does not have to be numeric[^my_footnote].
[^1]: Some footnote.
[^2]: Other footnote.
[^my_footnote]: This also works fine.
答案 2 :(得分:7)
如果您想使用redcarpet
,现在似乎没有方便的解决方案。
虽然Redcarpet 3 supports footnotes具有您使用的语法,但它不包含在Jekyll中,因为Redcarpet 3删除了Ruby 1.8兼容性(source)。
请参阅Jerod Santo的this solution:
使用以下内容将名为Gemfile
的文件添加到Jekyll文件夹的根目录:
source "https://rubygems.org"
gem "jekyll"
gem "redcarpet", github: "triplecanopy/redcarpet"
Theny将您的_config.yml
调整为
markdown: redcarpet
redcarpet:
extensions: [footnotes]
我不知道最简单的方法是什么。欢迎提出意见。