配置

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

markdown: kramdown
toc_levels: 1……2

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

使用

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

  • any list

    {:toc}

Extra

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

    #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

参考文献