Jekyll 在 Markdown 文档给 H1、H2-6 标题添加自定义锚点(HTML标签增加 id 属性)

最近在尝试翻译 Jekyll 的文档,从中学到了很多实用的使用方法,一些比较常用会记录到一极乐博客与大家分享。

1
2
## 安装 Jekyll
{: #install-jekyll}

Markdown 解析后的代码结构

1
<h2 id=“install-jekyll”>安装 Jekyll</h2>

如果要使用锚点,在链接加上 #install-jekyll 即可,比如链接是 https://yijile.com/ ,添加后 https://yijile.com/#install-jekyll ,访问时页面会自动滚动到 id=install-jekyll 的位置。

注意事项:

  1. 如果页面没有这个 id 的标签则访问时打开的是页面顶部,如果在当前页面设置这样的锚点链接就是回到当前页面顶部
  2. id 在一个页面中只能用1次,如何涉及 JavaScript 可能会有问题,对应 html 规范而言一个页面同一个 id 名称(指ID的值,如 id=”name”)出现多次也是不规范的。

Relay Tips: 一极乐https://yijile.com/log/551/