Возможны ли нумерованные заголовки в Markdown/Rdiscount?

Я пытаюсь создать html с заголовками раздела/подраздела, которые выглядят следующим образом:

Моя тема на верхнем уровне
1.1 Моя первая подтема
1.2 Еще одна подтема
1.2.1 Суб-подтемы

Еще одна тема верхнего уровня

Существуют ли какие-либо реализации Markdown, способные создавать такие виды нумерованных заголовков разделов?

Спасибо заранее.

Ответ 1

Да, попробуйте Pandoc. Это работает для меня:

pandoc --number-sections < test.md > out.html

(Источник)

Уценка для создания нумерованного контура, упоминаемого в исходном сообщении, выглядит следующим образом:

# My top-level topic

## My first subtopic

## Another subtopic

### A sub-subtopic

## Another top-level topic

Если вы хотите получить более глубокие отступы для подраздела, вы можете добиться этого с помощью встроенного CSS. Например, помещая это в верхнюю часть вышеуказанного источника Markdown, выпадающие заголовки:

<style type="text/css">
  h2 { margin-left: 10px; }
  h3 { margin-left: 20px; }
</style>

Но скажите, что у вас есть абзацы текста под заголовками... Я не знаю, как отступать на том же уровне, что и выше.

Обновление 2015-10-18: Markdeep имеет нумерованные заголовки (любые другие интересные функции). Проверьте это тоже!

Ответ 2

Если ваш инструмент уценки поддерживает настраиваемую тему по CSS, добавьте ниже фрагмент в CSS, чтобы включить номер заголовка:

body {
    counter-reset: h1
}

h1 {
    counter-reset: h2
}

h2 {
    counter-reset: h3
}

h3 {
    counter-reset: h4
}

h1:before {
    counter-increment: h1;
    content: counter(h1) ". "
}

h2:before {
    counter-increment: h2;
    content: counter(h1) "." counter(h2) ". "
}

h3:before {
    counter-increment: h3;
    content: counter(h1) "." counter(h2) "." counter(h3) ". "
}

h4:before {
    counter-increment: h4;
    content: counter(h1) "." counter(h2) "." counter(h3) "." counter(h4) ". "
}

Я использую Typora, который поддерживает авто нумерацию для заголовки в этом подходе.

Ответ 3

Как отмечает @adam-monsen, "pandoc -number-sections" делает трюк. Вы также можете просто добавить numbersections: true в YAML-заголовок, чтобы активировать нумерованные заголовки для вашего файла.