gitbook

name	gitbook
version	1.0.0
description	Publish documentation and books with GitBook including spaces, collections, variants, Git sync, collaboration, and API integration
author	workspace-hub
category	development
type	skill
capabilities	["Documentation publishing","Spaces and collections management","Content variants (versions)","Git synchronization","Team collaboration","API integration","Custom domains","Analytics"]
tools	["gitbook-api","git","curl","python-requests"]
tags	["gitbook","documentation","publishing","git-sync","collaboration","api"]
platforms	["web","api","git"]
related_skills	["mkdocs","docusaurus","sphinx","pandoc"]

GitBook

When to Use

USE GitBook when:

• Team documentation - Collaborative docs with multiple editors
• Product documentation - User guides, API docs, tutorials
• Knowledge bases - Internal wikis and knowledge management
• Multi-version docs - Maintain docs for different product versions
• Git-based workflow - Sync docs with GitHub/GitLab
• Custom branding - Need custom domains and styling
• Access control - Restrict docs to authenticated users

DON'T USE GitBook when:

• Complex code docs - Use Sphinx for Python API docs
• Static site control - Use MkDocs or Docusaurus
• Offline-first - GitBook is primarily cloud-hosted
• Self-hosted required - GitBook is SaaS (legacy self-hosted deprecated)

Prerequisites

GitBook Account Setup

# 1. Sign up at https://www.gitbook.com/
# 2. Create an organization (or use personal space)
# 3. Generate API token at https://app.gitbook.com/account/developer

export GITBOOK_API_TOKEN="gb_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

curl -s -H "Authorization: Bearer $GITBOOK_API_TOKEN" \
    "https://api.gitbook.com/v1/user" | jq '.id, .displayName'

Git Sync Setup

# In your GitBook space settings:
# 1. Go to Integrations > Git Sync
# 2. Connect GitHub/GitLab account
# 3. Select repository and branch

See sub-skills for full details.

Python Setup

uv add requests python-dateutil

Resources

• GitBook Documentation: https://docs.gitbook.com/
• GitBook API Reference: https://developer.gitbook.com/