Блог

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

В моем conf.py мои расширения markdown выглядят следующим образом после установки.

 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] в мой файл markdown, в котором есть несколько примеров заголовков

 <!--
.. 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].
он преобразует заголовки #в заголовки html, как и ожидалось
, но без оглавления.

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

[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