Пример использования github'овского генератора статических сайтов Jekyll.
Например такой результат:
Конечно же можно это всё ручками запилить и в большинстве случаев это придётся сделать. Но в еще большем количестве случаев достаточно донести информацию в чуть более симпатичной форме.
Для этого и нужен Jekyll - достаточно выбрать подходящую тему (можно и свою запилить), сделать репу на github.com*, настроить её и фигачить Markdown, не заморачиваясь над внешним видом.
* Jekyll можно использовать и без гитхаба - на локалке пройтись им по пачке Markdown, получить на выходе пачку обычных HTML+CSS+JS файлов и залить их куда надо.
Самый простой сценарий:
- Пишем обычный Markdown в файл
README.md
(можно прям через github) - Заходим в настройки репозитория
- Пролистываем до раздела GitHub Pages
- В выпадашке Source выбираем ветку
master branch
и нажимаем Save
- Выбираем тему в следующей выпадашке, если нужно
- Обновляем страницу до тех пор, пока не увидите надпись
Your site is published at ...
в шапке раздела GitHub Pages - Переходим на страничку, сгенеренную в разделе 5.
- 😎