目录

每个页面/部分都会根据 markdown 生成的标题自动为自己生成一个目录。

page.toc它通过或变量在模板中可用section.toc。您可以查看模板变量 文档以获取有关其结构的信息。

以下是使用该字段呈现两级目录的示例：

{% if page.toc %}
    <ul>
    {% for h1 in page.toc %}
        <li>
            <a href="{{ h1.permalink | safe }}">{{ h1.title }}</a>
            {% if h1.children %}
                <ul>
                    {% for h2 in h1.children %}
                        <li>
                            <a href="{{ h2.permalink | safe }}">{{ h2.title }}</a>
                        </li>
                    {% endfor %}
                </ul>
            {% endif %}
        </li>
    {% endfor %}
    </ul>
{% endif %}

虽然在此示例中标头排列整齐，但它与不相交的标头一样有效。

请注意，标题中所有现有的 HTML 标记都不会出现在目录中，以避免出现各种问题。