Importing content
How to import existing content into GitBook from Confluence, Notion, Git and more
You can migrate and unify existing documentation in GitBook using the import tool.
You have the option to import single or multiple pages using our built-in import tool — or an entire Git repository using Git Sync.
Using the Import Panel
Supported import formats
GitBook supports imports from websites or files in the following formats:
Markdown (
.md
or.markdown
)HTML (
.html
)Microsoft Word (
.docx
)
We also support imports from:
Confluence
Notion
GitHub Wiki
Quip
Dropbox Paper
Google Docs
If you want to import multiple pages, you can upload a ZIP file containing HTML or Markdown files.
GitBook is Markdown-based, so importing content in Markdown format will yield the best results. If your current tools support exporting in Markdown, we recommend using that format for a smoother import process.
The Import panel
When you create a new space, you’ll have the option to import content from the bottom sheet of the first empty page.
After choosing an input source, you can select the file you’d like to import.
GitBook imports content from various sources, but differences in product features and document formats may cause variations in the imported content compared to the original source.
Limitations
GitBook currently has the following limits for imported content:
The maximum number of pages that can be uploaded in a single import is 20.
The maximum number of files (images etc.) that can be uploaded in a single import is 20.
Import using Git Sync
For importing large volumes of content into GitBook, we recommend using Git Sync. Unlike our integrated import tool, Git Sync is better suited for handling larger migrations efficiently.
Here’s how to do it:
Convert your content into Markdown
GitBook is Markdown-based, so importing content in Markdown format will yield the best results. If your current tools support exporting in Markdown, we recommend using that format for a smoother import process.
If your content isn’t already in Markdown files, we recommend using a script (like Martkitdown) or an online tool to convert your content.
Organize your content in GitHub or GitLab
When setting up your GitBook site, it’s crucial to organize your content in your GitHub or GitLab repository efficiently. Since Git Sync occurs at the space level, carefully plan how to group your content. Create multiple repositories or folders, ensuring the necessary Markdown files are in the correct locations.
Set up spaces and Git Sync
To organize your content, create one or more spaces in GitBook as needed. Install the GitHub Sync or GitLab Sync integrations in your organization and configure it for those spaces. You’ll need to synchronize your space with the folder or repository you set up in the previous step.
Last updated