Jekyll link 页面内

Question

我在 Github 上使用 Jekyll，我想知道是否有办法 link 到页面中的某个部分。假设我有一个像

这样的部分

## Section 1 ##
section content 

稍后在同一页中我想 link 到此部分。我已经找到如何 link to another page within the blog and do footnotes，但不是这个。

请注意，我在 _config.yml

中使用 markdown: kramdown

Answer 1

kramdown supports the automatic generation of header IDs if the option auto_ids is set to true (which is the default). This is done by converting the untransformed, i.e. plain, header text

所以在上面的例子中## Section 1 ##，它会生成下面的id：id="section-1"，然后anchor通过A元素链接到：

<A href="#section-1">Section One</A>

或者简单地说 kramdown/markdown：[Section 1](#section-1)

Answer 2

这似乎已更改为#heading-section-1（现在正在检查 Jekyll 3.7.3）。

作为一种自行解决此问题的方法，您可以检查元素并查看呈现页面上使用的 ID。

Answer 3

我找到了一个不错的存储库，它可以通过三个简单的步骤帮助向所有 headers 添加锚点。

来自docs：

1. 从 the master branch

   下载 anchor_headings.html 文件

2. 将那个文件扔到你的 _includes 文件夹中

3. 通常在布局中放置 {{ content }} 的位置， 您可以改为使用此 Liquid 标签来输出您的页面内容：

   {% include anchor_headings.html html=content anchorBody="#" %}

结果你会看到：

哪个容易customize。