Команда Peakline (аналитика тренировок для Strava) рассказала, как за пару вечеров превратила хаотичную коллекцию .md-файлов в современный портал документации с поиском, мультиязычностью и трендовым дизайном. Основой решения стал Python-стек: генератор статических сайтов MkDocs и тема Material for MkDocs.

Ключевые преимущества связки — простота (Markdown, без сложных компонентов), высокая скорость (статичный HTML, кэширование, быстрый хостинг), богатый функционал «из коробки» (адаптивность, тёмная/светлая тема, встроенный поиск, блоки, табы, подсветка синтаксиса, мультиязычность). Пошагово показаны:

• Правильная установка через виртуальное окружение Python для избежания системных ошибок.
• Минимальные настройки и готовый конфиг mkdocs.yml (дизайн, язык, навигация, UI-компоненты).
• Мультиязычность — просто копируются папки и добавляются ссылки.
• Деплой на Nginx и настройка HTTPS через Certbot одной командой.

В результате портал полностью автоматизирован: новые члены команды быстро находят нужное, обновления и локализация делаются мгновенно. Автор делится не только конфигами, но и «граблями», с которыми сталкиваются все реальные проекты. Итог — стильная, удобная и быстрая документация, пригодная для любого IT-проекта.