Import of GitHub Wikis

GitBook doesn't support auto-import and synchronization with a GitHub Wiki ( We are working on it!). But since GitBook supports synchronization with a repository, with a few manual steps, a GitHub Wiki can be imported to GitBook.

1. Create a temporary GitHub repository

Create a new temporary GitHub repository for example : YOUR_USERNAME/repo-wiki. This repository will be used to store the content from the GitHub Wiki for the initial import to GitBook.

2. Clone the wiki and push it the temporary repository

Each GitHub Wiki is associated to its own Git repository, you can find the Git url to clone in the right sidebar of the wiki (See GitHub documentation).

git clone https://github.com/YOUR_USERNAME/YOUR_REPOSITORY.wiki.git

Once this repository has been cloned on your computer, you can push it back to the temporary GitHub repository by changing the remote:

git remote set-url origin https://github.com/You/repo-wiki.git

If your wiki has a _Sidebar.md file, you can rename this file to SUMMARY.md. The markdown file extension (.md) should be added to all links in this file (See the documentation about SUMMARY).

3. Import the repository on GitBook

Now that your content is in a normal GitHub repository, you can create a space on GitBook and synchronize it with this repository.

Once your content has been imported, you can deactivate the GitHub integration on this space.