Никола Оглавление в формате Markdown

Question

Я установил Nikola (https://getnikola.com/) и создал файл уценки, который успешно отображается как сообщение.

В моем conf.py мои расширения уценки после установки выглядят так.

MARKDOWN_EXTENSIONS = ['markdown.extensions.fenced_code', 'markdown.extensions.codehilite', 'markdown.extensions.extra']

Кажется, что оглавление должно быть включено по умолчанию, поэтому я включил его

MARKDOWN_EXTENSIONS = ['markdown.extensions.fenced_code', 'markdown.extensions.codehilite', 'markdown.extensions.extra','markdown.extensions.toc']

а затем добавил текст [TOC] в мой файл уценки, в котором есть несколько примеров заголовков

<!--
.. title: Witness the Quickness
.. slug: witness-the-quickness
.. date: 2020-10-26 18:46:36 UTC
.. tags: 
.. category: 
.. link: 
.. description: 
.. type: text
-->


[TOC]
Sample text with some headings below

# Well, Well well

## Duppy guides my hand

### The smiles on their faces

В сгенерированном html-файле он просто отображает текст [TOC]. он преобразует #Headings в заголовки html, как и ожидалось, но не оглавление.

Есть ли другие настройки, которые нужно изменить / включить, чтобы это работало?

Answer 1

[TOC]должен быть в отдельном абзаце. Добавьте новую строку, например:

<!--
.. title: Witness the Quickness
.. slug: witness-the-quickness
.. date: 2020-10-26 18:46:36 UTC
.. tags: 
.. category: 
.. link: 
.. description: 
.. type: text
-->


[TOC]

Sample text with some headings below

# Well, Well well

## Duppy guides my hand

### The smiles on their faces