Importing documents

To use this feature as its most, we recommend using:

• DocBook v5.x documents

If you have existing DocBook documents in version 4, consider converting it automatically to version 5 for optimized compatibility.

divide a big document into chapters and sub-chapters, based on the document’s structure. Thus, each first-level header of the original document will be converted to a chapter. If a chapter contains second-level headers, a folder instead of a new file is created for this chapter. This folder will contain each sub-chapters.

In a chapter’s folder, a README.md file containing the chapter preface is created. The whole content before the first second-level header is considered to be a chapter preface. The same rule applies for the whole content before the first first-level header which is used as the book’s preface.

If you ever need more flexibility, consider using gitbook-convert locally, create a repository and import it using Git or GitHub.

We’re always happy to help out with your books or any other questions you might have. You can ask a question or signal an issue on the following form at .