clidoc — маленькая Ruby (ruby-ronn) консольная утилита для создания справочных страниц (man pages) и текстовых руководств (help text) из Markdown-документов.
Markdown — представленный в 2004 году облегчённый язык разметки, созданный с целью написания наиболее читаемого и удобного для правки текста, но пригодного для преобразования в языки для продвинутых публикаций (HTML, Rich Text и других). Markdown не является заменой HTML, его синтаксис достаточно ограничен и соответствует лишь небольшому подмножеству элементов HTML.
clidoc является обёрткой для утилиты ronn, значительно упрощающий её использование. С помощью ronn преобразуется Markdown-документ в Groff-файл (man pages) и HTML-документ. После анализа HTML-файла текст преобразуется в руководство, используя возможности утилиты xidel (инструмент для загрузки и извлечения данных из HTML/XML-страниц).
Лицензия: GNU General Public License version 3.0 (GPLv3)
