Kramdown扩展

Question

Kramdown有一个很酷的内容生成表

{: .toc}

这将生成一个很好的TOC，如html中的顺序/无序列表，如下所示：

<ul id="markdown-toc">
   <li></li>
   ...
</ul>

但有时我想控制更多，比如使用引导List Group，甚至使用<div>标记，然后使用<ul><li></li></ul>。

有没有一种方法可以继承/重写这个toc模块来生成我自己的标记？

注意:我在jekyll中使用了github页面。

Answer 1

不幸的是，没有-- {: toc}语法除了通过toc_levels不接受任何修改(这允许您指定toc深度；有关详细信息，请参阅备选文件 )。实际上，您可以根据是否使用你是希望这份清单是无序的还是被订购的？指定

* Table of contents
{: toc}

或

1. Table of contents
{: toc}

还可以通过使用{: .no_toc}选项排除标头(至少在使用auto-ids时是这样的，因为只添加了带有id的标头，如果不使用该选项，也可以不提供id)：

# Header
{: .no_toc}

还有任何与CSS、Javascript或后置处理有关的内容。但是，这通常比较简单，因为您可以将整个toc封装在一个<div>中，如果您希望或者添加任何您想要的类到包含toc的<ul>/<ol>中。如果您在让toc在div中生成时遇到了困难，请确保允许在目录本身包含parse_block_html或markdown="block"选项的情况下使用块级解析。例如,

# Header

<div markdown="block" id="xyzzy">
* TOC
{: toc .class}
</div>

应生成

<h1 id="header">Header</h1>

<div id="xyzzy">
<ul class="class" id="markdown-toc">
  <li><a href="#header" id="markdown-toc-header">Header</a></li>
</ul>

</div>