Сгенерировать идентификаторы в заголовках

Question

Мой сайт использует Jekyll с парсером уценки Redcarpet. Я хотел бы сделать это так, мои заголовки автоматически генерируются с идентификаторами:

# My heading 

становится:

<h1 id="my-heading">My heading</h1> 

Но я не нашел способ.

Я хотел бы придерживаться redcarpet в качестве анализатора разметки, но это не обязательно. Если есть еще один, который поддерживает все те же функции, я бы с радостью подумал об этом. Мне особенно нравится, что redcarpet генерирует кодовые блоки в формате pygments.

Answer 1

Мои предпочтительные решения является @maul-esel's Github Issues answer:

redcarpet README упоминает вариант конфигурации with_toc_data. Это создает идентификаторы для заголовков, которые выглядят как id="toc_0" и т.д.

Вы можете включить его, добавив это в свою _config.yml Джекил конфигурации:

markdown: redcarpet 
redcarpet: 
    extensions: [with_toc_data] 

Это не идеальный - я бы предпочел более семантические идентификаторы как id="my-heading" - но это достаточно хорошо, и это очень просто - это означает, что мне не нужно настраивать и учиться другому парсеру разметки (или проработать, как продлить красную дорожку).

Answer 2

Если это помогает, это делает работу с Kramdown

$ kramdown <<< '# My heading' 
<h1 id="my-heading">My heading</h1>