配置

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

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

参考文献