ruby - 在标题中生成 ID

Question

我的网站使用 Jekyll 和 Redcarpet markdown 解析器。我想让它自动生成带有 id 的标题:

# My heading

变成:

<h1 id="my-heading">My heading</h1>

但是我还没有找到办法。

我想坚持使用 redcarpet 作为我的 Markdown 解析器，但这不是必需的。如果有另一个支持所有相同功能的，那么我会很乐意考虑它。我特别喜欢 redcarpet 以 pygments 格式生成代码块。

Answer 1

我首选的解决方案是 @maul-esel's Github Issues answer :

redcarpet README提到配置选项 with_toc_data。这会为看起来像 id="toc_0" 等的标题生成 ID。

您可以通过将其添加到您的 _config.yml Jekyll 配置中来启用它:

markdown: redcarpet
redcarpet:
    extensions: [with_toc_data]

这并不理想 - 我更喜欢更多的语义 ID，如 id="my-heading" - 但它已经足够好而且 super 简单 - 这意味着我不需要设置和学习另一个 Markdown 解析器(或研究如何扩展 Redcarpet )。