Задать вопрос

Генерация html документации на основе markdown файлов

День добрый,
решил оптимизировать пользовательскую документацию и привести ее к виду удобной для коллективного работы.

Требования:
Форматирование исходных файлов — markdown.
Генерация многостраничной документация (многие генераторы работают только с одним файлом).
Self-host
Желательно наличие уже готовых шаблонов, которое было бы достаточно только изменить.

Пока остановился на следующих вариантах:
Beautiful docs
mdoc
markdoc

Может у кого-то уже был опыт по поиску похожего решения?

Спасибо!

note: я так же тестировал sphinx-doc — хорошая система генерации, но использует reStructuredText. Можно конечно заморочиться и сделать прозрачную конвертацию через pandoc, но пока пытаюсь найти альтернативу.
  • Вопрос задан
  • 4445 просмотров
Подписаться 9 Оценить Комментировать
Пригласить эксперта
Ответы на вопрос 2
rich
@rich
Например Web-framework sw.
Ответ написан
Комментировать
@plutov
А вот и документация вышла по Markdown - plutov.by/post/markdown_docs
Ответ написан
Комментировать
Ваш ответ на вопрос

Войдите, чтобы написать ответ

Похожие вопросы