Docusaurus или ReadMe: что выбрать
Docusaurus и ReadMe — сервисы одной категории «Документация и база знаний». Docusaurus — разработчикам и продуктовым командам, которые хотят документацию в git без подписки. ReadMe — компаниям с публичным API, которым нужны интерактивная документация и аналитика использования. Из России Docusaurus работает без ограничений, а ReadMe работает, но оплатить можно только зарубежной картой.
| Docusaurus | ReadMe | |
|---|---|---|
| Цена | Бесплатный генератор с открытым кодом (MIT) | Бесплатный тариф Starter для одного проекта |
| Бесплатный план | есть | есть |
| Работа из России | Работает в России | В России: нужна зарубежная карта |
| Русский язык | есть | нет |
| Платформы | Веб, Windows, macOS, Linux | Веб, API |
| Итог | Лучший бесплатный генератор документации для команд, которые работают через git. | Сильная платформа документации API с аналитикой, но командная работа стоит от $250 в месяц. |
Docusaurus — это бесплатный генератор сайтов документации от Meta: вы пишете страницы в Markdown или MDX, а он собирает быстрый статический сайт с навигацией, поиском и версиями.
Кому подходит: Разработчикам и продуктовым командам, которые хотят документацию в git без подписки.
Кому не подходит: Командам без разработчиков, которым нужен визуальный редактор.
Плюсы
- Бесплатный и с открытым кодом
- Версии документации и мультиязычность из коробки
- Компоненты React внутри Markdown
- Размещение на любом хостинге
Минусы
- Нет визуального редактора
- Нужен опыт с Node.js и git
- Поиск требует подключения Algolia или плагина
Тарифы
| Тариф | Цена | Что входит |
|---|---|---|
| Docusaurus | бесплатно | Генератор сайта, лицензия MIT |
| Хостинг | от $0 | GitHub Pages, Vercel или свой сервер |
ReadMe — платформа для документации API: справочник с интерактивными запросами, руководства, журнал изменений и аналитика использования API в одном месте.
Кому подходит: Компаниям с публичным API, которым нужны интерактивная документация и аналитика использования.
Кому не подходит: Небольшим проектам без бюджета и командам, которым нужна только база знаний.
Плюсы
- Интерактивный справочник из OpenAPI
- Логи запросов и аналитика использования API
- Синхронизация с GitHub
- llms.txt и MCP-сервер для AI-ассистентов
Минусы
- Pro стоит $250 в месяц
- Бесплатный тариф только для одного администратора
- Оплата только зарубежной картой
Тарифы
| Тариф | Цена | Что входит |
|---|---|---|
| Starter | $0 | 1 проект, 1 версия, свой домен, справочник API, llms.txt |
| Pro | $250/мес. при оплате за год | Команда, ветки и ревью, приватные документы, журнал изменений |
| Enterprise | по запросу | SSO, роли, аудит, несколько проектов |
Подробно — на страницах Docusaurus и ReadMe.
Веб-сервис
Личный кабинет, админка или MVP под ключ
Next.js и Supabase, спецификация до старта и фиксированная цена. MVP — от 4 недель, клиентская часть — от 300 000 ₽.
Удобнее голосом? Запишитесь на 30 минут в Zoom — разберём задачу и решим, с чего начать.