GitHub & GitLab Sync

Synchronize your GitBook docs with GitHub or GitLab with GitBook’s bi-directional integration

Set up Git Sync for your GitBook docs.

Overview

Git Sync allows technical teams to sync GitHub or GitLab repositories with GitBook and turn a repo of Markdown files into beautiful, user-friendly docs. Edit directly in GitBook’s powerful editor while keeping content synchronized with your codebase on GitHub or GitLab.

Git Sync is bi-directional, so changes you make directly in GitBook’s editor are automatically synced, as are any commits made on GitHub or GitLab. This allows developers to commit directly from GitHub or GitLab and technical writers, instructional designers, and product managers to edit, discuss and feedback changes directly in GitBook.

Set up Git Sync

Set up GitHub Sync

Set up and authorize the GitHub integration for GitBook.

Set up GitLab Sync

Set up and authorize the GitLab integration for GitBook.

Git Sync supports IP allowlisting for Enterprise customers. If your GitHub, GitLab, or internal network only accepts traffic from approved IPs, allowlist these outbound Git Sync IPs before you enable the integration:

• 34.136.22.210
• 34.29.189.57
• 35.223.181.150
• 34.72.115.112
• 136.116.236.109

Only administrators and creators can enable and configure Git Sync.

Working with AI Agents

When working on your docs locally with Git Sync, you can use GitBook's skill.md file to provide an AI coding assistant with context about GitBook's blocks, features, and best practices.

Head to Agent skills to learn more.