GitBook

Что такое GitBook?

GitBook — платформа документации, заявленная цель которой — поддерживать точность документации и для людей, и для ИИ. Команды пишут в блочном редакторе или в Git-репозитории, публикуют сайты документации и добавляют ИИ-функции с двух сторон: GitBook Agent помогает авторам готовить черновики, импортировать, переводить и проверять контент, а ИИ-ассистент отвечает на вопросы читателей по опубликованной документации.

За продуктом стоит компания GitBook Inc, зарегистрированная в США, с французской дочерней компанией GitBook SAS.

Большинство решений о покупке определяют три факта. Оплата взимается за каждый опубликованный сайт плюс за каждого участника организации, поэтому расходы растут и с числом сайтов, и с размером редакционной команды. ИИ-чат для читателей, ИИ-аналитика и каналы Slack/Linear/GitHub входят в тариф Ultimate, а не в Premium. Кроме того, GitBook не возвращает деньги; отмененный тариф действует до конца расчетного периода и затем не продлевается.

Ключевые функции

GitBook сочетает визуальный редактор с процессами docs-as-code и добавляет ИИ поверх того же контента. Авторы и читатели опираются на один источник: то, что правит Agent, позже цитирует ассистент, а выводы из вопросов читателей влияют на то, что будет написано дальше.

• Git Sync (docs-as-code): Git Sync работает в обе стороны, поэтому правки в редакторе GitBook и коммиты, отправленные в GitHub или GitLab, синхронизируются автоматически.
• Поиск устаревшего контента: GitBook сканирует документацию в поисках контента, который больше не соответствует продукту, и помечает его для проверки, не дожидаясь, пока читатели сообщат об устаревших страницах.
• Импорт через GitBook Agent: в боковой панели чата GitBook Agent можно прикрепить PDF и документы Microsoft Word, а Agent извлечет содержимое и оформит его в страницы.
• GitBook Agent как рецензент: добавленный рецензентом запроса на изменение, GitBook Agent может работать как линтер документации, отмечать нарушения руководства по стилю и предлагать или вносить исправления ошибок.
• ИИ-ассистент для читателей: он отвечает по сайту документации и подключенным к нему источникам, показывает читателям раскрывающийся список источников каждого ответа и связанные уточняющие вопросы.
• Интерактивная песочница API: они позволяют читателям тестировать эндпоинты API прямо в документации и входят во все тарифы, включая Free.
• Адаптивный контент: в Ultimate он показывает или скрывает материалы для отдельных пользователей по критериям, заданным командой, с учетом ограничений по сегментам.

Agent и ассистент — разные продукты с отдельными правилами тарифов. Agent работает на стороне редактирования и имеет бесплатный недельный лимит; полноценный чат ассистента — функция Ultimate, а в Premium доступно более простое поле ответа в ИИ-поиске. Где находится каждый из них, показано в разделе «Ценообразование» ниже.

Руководство

Перенос существующей документации в GitBook

1. При создании раздела откройте панель импорта, затем вставьте URL существующего онлайн-сайта документации или загрузите файлы Markdown, HTML либо Microsoft Word (.docx). По умолчанию GitBook применяет к импортированному контенту ИИ-очистку; ее можно отключить в меню.
2. Укладывайтесь в лимиты импорта при каждой загрузке. Один импорт ограничен 20 страницами и 20 файлами, GitBook не может повысить эти лимиты, а крупные миграции выполняются через Git Sync, который поддерживает до 5 000 страниц Markdown.
3. Для документации в репозитории подключите GitHub или GitLab через Git Sync. Включать и настраивать Git Sync могут только администраторы и создатели, поэтому остальным участникам для настройки нужна одна из этих ролей.

Добавление переведенной версии

1. Администратор организации открывает «Переводы» на боковой панели главной страницы организации, нажимает «Создать перевод» и выбирает исходный раздел и целевой язык. Создавать переводы и получать к ним доступ могут только администраторы организации, так как функция платная.
2. Добавьте готовый перевод на опубликованный сайт как вариант — тогда читатели смогут переключать язык переключателем в правом верхнем углу сайта документации.

Сценарии и примеры использования GitBook

• Закрытая продуктовая или внутренняя документация: доступ с аутентификацией рассчитан на конфиденциальную продуктовую документацию для платящих клиентов, потенциальных клиентов отдела продаж или партнеров; второй его сценарий — внутренняя база знаний, доступная только сотрудникам компании.
• Продуктовые хабы и порталы для разработчиков: разделы и группы Ultimate объединяют документацию нескольких продуктов на одном сайте; их описывают как подходящие для продуктовых хабов, порталов для разработчиков и справочных центров.
• Смешанные команды инженеров и авторов: разработчики могут делать коммиты прямо из GitHub или GitLab, а технические писатели, методисты и продакт-менеджеры редактируют и обсуждают те же изменения в GitBook.
• Поиск пробелов в документации: ИИ-аналитика показывает, как ассистент отвечал на вопросы пользователей, чтобы команды могли выявить пробелы в знаниях, которые нужно закрыть.

Большинство этих сценариев зависит от функций выше тарифа Free. Git Sync и публичный сайт документации на адресе, размещенном GitBook, работают во Free с одним пользователем; закрытые аудитории, многопродуктовые сайты и ИИ-аналитика по читателям требуют Ultimate.

Для кого предназначен

Собственные описания тарифов GitBook соотносятся с четырьмя аудиториями: Free рассчитан на частных лиц, Premium — на публичные брендированные сайты документации, Ultimate — на централизованную документацию с ИИ, а Enterprise — на глобальные команды, масштабирующие документацию.

• Частные лица и одиночные мейнтейнеры: студентам, ведущим личные и учебные заметки, рекомендуют тариф Free, который бесплатно дает неограниченный объем приватного контента.
• Команды разработки с документацией в Git: командам, которым нужно, чтобы авторы и инженеры работали с одними и теми же файлами Markdown, двусторонняя синхронизация с GitHub или GitLab доступна на всех тарифах, включая Free.
• Подходящие некоммерческие организации, проекты с открытым исходным кодом и образовательные группы: они могут подать заявку на бесплатный тариф Community, но критерии исключают проекты в сфере криптовалют и игр, а проект с открытым исходным кодом не должен быть связан с коммерческой компанией или компанией, получившей венчурное финансирование.
• Подходит меньше: организации, которым нужно много отдельных сайтов или много участников в приложении, платят за каждый сайт и каждого участника, поскольку плата за сайт и за участника начисляется независимо.

Платформы

GitBook — размещенный сервис: команды работают в приложении GitBook и публикуют сайты документации, а большинство вопросов о платформах касается того, к чему эти сайты подключаются.

• Хостинг Git: GitHub и GitLab через Git Sync; список разрешенных IP для Git Sync доступен только клиентам Enterprise.
• Командные чаты и трекеры задач: каналы интегрируют GitBook Assistant и GitBook Agent в Slack, Linear и GitHub.
• ИИ-инструменты и агенты: у каждой опубликованной страницы есть Markdown-версия, а каждый опубликованный сайт предоставляет llms.txt, llms-full.txt и MCP-сервер, к которым могут обращаться совместимые ИИ-инструменты.
• Встраивание: ассистента можно встроить в собственный сайт или продукт; в опубликованной документации он находится на боковой панели в Ultimate или в поле поиска в Premium и Ultimate.
• Провайдеры входа: доступ с аутентификацией использует интеграции с Okta, Azure и Auth0 либо собственный сервер аутентификации, который клиент размещает, программирует и поддерживает сам.

Ценообразование

Цены GitBook складываются из платы за тариф для каждого сайта и платы за каждого участника организации.

Страница цен указывает при годовой оплате Premium от $65 за сайт в месяц и Ultimate за $249 за сайт в месяц, а дополнительных пользователей — по $12 за пользователя в месяц. Там же сказано, что все суммы — это ежемесячная стоимость при годовой оплате, а годовой вариант помечен как «два месяца бесплатно», но прейскурантная цена при помесячной оплате не показана. Страница политики оплаты, напротив, указывает Premium за $65 за сайт в месяц плюс $12 за участника и использует те же ставки в примере пропорционального перерасчета при помесячной оплате, так что две официальные страницы описывают помесячную цену по-разному.

• Трафик: GitBook не ограничивает трафик на опубликованную документацию, а просмотры страниц указаны как неограниченные.
• Объем бесплатного уровня: тариф сайта Basic за $0 включает одного пользователя. Сайтов Basic можно создавать сколько угодно и бесплатно, но собственные домены, расширенная настройка и другие премиум-функции требуют перевода этого сайта на платный тариф.
• ИИ по тарифам: ИИ-поиск доступен в Premium и Ultimate, а GitBook Assistant, ИИ-аналитика и каналы по-прежнему есть только в Ultimate.
• Лимит ассистента: сравнительная таблица указывает для ИИ-ассистента 500 успешных ответов, помечая это как мягкий лимит; сверх него можно связаться с компанией, доступны и индивидуальные уровни.
• Оплата дополнений: дополнения, например расширенный ИИ-ассистент и «Переводы», включают ежемесячный лимит; при превышении функция продолжает работать, а дополнительное использование выставляется в следующем счете в конце расчетного периода.
• Дополнение «Переводы»: переводы стоят $25 в месяц или $250 в год за объем до 50 000 переведенных слов в месяц плюс $0.20 за каждые дополнительные 1 000 слов; лимит слов обнуляется в начале каждого месяца.
• GitBook Agent: справочная страница Agent описывает его как бесплатный для всех тарифов на время беты, с бесплатным лимитом 10 сообщений в неделю для аккаунтов, которые не на Pro и не на пробном периоде.
• Пробный период: для Premium и Ultimate указан бесплатный пробный период 14 дней. Он начинается, когда сайт публикуется для аудитории или приглашаются дополнительные участники, не требует способа оплаты и открывает для тестирования все функции Ultimate.
• Участники: участники организации стоят одинаково независимо от прав доступа, поэтому гости и читатели в приложении оплачиваются как редакторы.
• Запросы на повышение тарифа: повышение тарифа нужно подтвердить в модальном окне с деталями и ценой тарифа; публикация сайта с функциями Premium или Ultimate, добавление собственного домена или расширенной настройки могут вызвать этот запрос.
• Годовой перерасчет: при годовой оплате увеличения в течение срока оплачиваются через годовой перерасчет, счет за который может прийти отдельно до продления.
• Возвраты и скидки: GitBook не возвращает деньги, а неиспользованные средства зачисляются на счет аккаунта для будущего использования. Помимо двух бесплатных месяцев на годовых тарифах и бесплатного тарифа Community, других скидок сейчас нет.
• Способы оплаты: оплата по счету доступна в Enterprise; на других тарифах платят банковской картой или местными способами оплаты, доступными в регионе покупателя.
• Тариф Community: тариф Community бесплатен для подходящих некоммерческих организаций, организаций с открытым исходным кодом и образовательных групп и включает все функции Ultimate, кроме SAML SSO.

Альтернативы GitBook

Альтернативы GitBook делятся на две группы: другие размещенные платформы документации и универсальные вики, с которых команды часто переходят.

• Mintlify: уровень Starter у Mintlify рассчитан на частных лиц и небольшие команды, в нем указаны 5 мест редакторов, собственный домен, аутентификацию, MCP-сервер и песочницу API; компания утверждает, что начать можно бесплатно. В ее платном уровне для стартапов и растущих команд указаны неограниченное число мест редакторов, Agent и ассистент.
• Существующие вики и инструменты документации: GitBook поддерживает импорт из Confluence, Notion, GitHub Wiki, Quip, Dropbox Paper и Google Docs, поэтому у команд, уходящих с этих инструментов, есть прямой путь миграции.

Главный компромисс — единица тарификации. GitBook берет плату за сайт и за участника и держит ИИ-чат для читателей в Ultimate, тогда как уровни Mintlify построены вокруг мест редакторов и включают ассистента в платный уровень. Команды с одним сайтом документации и небольшой группой авторов ощущают эту разницу меньше, чем команды с несколькими сайтами.

Ограничения

Ограничения продукта

• Охват ассистента: он не отвечает сразу по опубликованным разделам, расположенным на разных сайтах документации; поиск по нескольким разделам работает только в пределах одного сайта.
• Расходы на перевод могут резко вырасти: изменение глоссария перевода запускает полный повторный перевод, а небольшая правка большой страницы приводит к повторному переводу и оплате всей страницы.
• Задержка ИИ-поиска: изменения контента могут появиться в результатах ИИ-поиска только через срок до одного часа.
• Перерыв в оплате отрезает команду: окончание пробного периода, неудачный платеж или истекшая подписка могут сразу ограничить совместную работу, лишив участников доступа, при этом основной администратор доступ сохраняет.
• Неоднозначные внешние отзывы: по данным на 5 октября 2026 года, профиль компании GitBook на сторонней платформе отзывов показывал оценку 3,8 по 23 отзывам, 52 % из которых — с одной звездой, и уведомление о том, что отзывы могут быть нерепрезентативными, поскольку компания в последнее время не приглашала клиентов.

Конфиденциальность и данные

• Обучение ИИ-моделей: GitBook Agent не использует данные клиентов для обучения ИИ-моделей, а добавленная в него информация передается OpenAI только для работы Agent.
• Обработка для ИИ-поиска: GitBook AI передает контент OpenAI для индексации и обработки, и GitBook заявляет, что OpenAI не использует этот контент для улучшения сервисов, включая обучение моделей.
• Вопросы читателей: справочная страница ИИ-ассистента не сообщает, используются ли вопросы читателей для обучения моделей.
• Хостинг и шифрование: данные клиентов хранятся в дата-центрах в США на Google Cloud и шифруются при хранении и передаче, но часть HTML-страниц и ресурсов может кэшироваться CDN в других регионах.
• Сертификаты: GitBook заявляет о соответствии SOC 2, ISO 27001 и GDPR и предлагает SSO на основе SAML.
• Данные при регистрации: для регистрации нужен только адрес электронной почты, но в зависимости от оценки рисков адреса почты и IP-адреса у новых пользователей могут запросить номер телефона.
• Хранение аккаунтов: GitBook не удаляет неактивные аккаунты автоматически, а после запроса на удаление, по его словам, удаляет весь профиль в течение 90 дней, если этому не препятствуют требования закона.
• Скрытое не значит закрытое: скрытые страницы по-прежнему входят в llms-full.txt и остаются доступны через MCP-сервер сайта, потому что скрытие лишь убирает страницу из опубликованного оглавления.

ЧаВо

Q1. Нужна ли банковская карта, чтобы попробовать платные функции GitBook?

Нет. 14-дневный пробный период начинается, когда вы публикуете сайт для аудитории или приглашаете новых участников, и не требует способа оплаты. По его окончании вы выбираете тариф или переходите на бесплатную версию.

Q2. Можно ли вернуть деньги за подписку GitBook?

GitBook не возвращает деньги. Неиспользованные средства зачисляются на счет аккаунта для будущего использования, а при подозрении на ошибку в счете GitBook направляет к своей службе поддержки.

Q3. Использует ли GitBook мою документацию для обучения ИИ-моделей?

GitBook заявляет, что GitBook Agent не использует ваши данные для обучения ИИ-моделей и передает их OpenAI только для работы Agent. Для ИИ-поиска контент передается OpenAI, которая, по словам GitBook, не использует его для обучения моделей. Справочная страница ИИ-ассистента не касается того, используются ли вопросы читателей для обучения.

Q4. Могут ли проекты с открытым исходным кодом пользоваться GitBook бесплатно?

Подходящие проекты с открытым исходным кодом могут подать заявку на бесплатный тариф Community, который включает все функции Ultimate, кроме SAML SSO. Проекты, связанные с коммерческой компанией или компанией с венчурным финансированием, не подходят.