Jekyll x kramdown TOC 目录生成

2022-09-21 09:49:02 浏览数 (1)

  • 配置

  • 使用
  • Extra
  • Better solution for Responsive TOC
  • 参考文献

配置

首先需要对 _Config.yml 进行配置

代码语言:javascript复制
markdown: kramdown
toc_levels: 1……2

第二个参数是决定 h1 到 h2 的标题都会自动生成, 可以根据需要自己改

使用

然后在需要添加目录的文章里面添加以下文字

  • any list {:toc}

Extra

可以对 TOC 列表进行一定的美化, 使用最简单的 CSS 即可

代码语言:javascript复制
    #markdown:before {
        content: "目录";
        font-weight: bold;
    }
    ul#markdown-toc {
        list-style: none;
        position: fixed;
        padding: 0px;
        left: 10px;
        bottom: 200px;
        border-radius: 0.3em;
        box-shadow: rgba(0,0,0,0.15) 0 1px 4px;
        box-sizing: border-box;
        border: #fff 0.5em solid;
        background-color: white;
    }

Better solution for Responsive TOC

Link: awesome-toc

参考文献

  • 为 Octopress 添加 TOC

0 人点赞