导入文档

为了充分使用它的特性，我们推荐你使用：

• DocBook v5.x 文档

If you have existing DocBook documents in version 4, consider to version 5 for optimized compatibility.
如果你有 DocBook v4.x 的文档，可以考虑将它们 转化 成 DocBook v5.x 来解决兼容性问题。

根据文章的结构，将文章划分成章节和子章节。因此，原始文档的一级标题都会被转化成一个章节。如果一个章节包含二级标题，则会为这个章节创建一个目录来包含每个子章节。

在章节目录里，会创建一个包含章节前言的 README.md 文件。第一个二级标题前的所有内容会被认为是一个章节的前言。这样的规则同样适用于第一个一级标题前的所有内容，它们会成为为书的前言。

如果你需要更多的灵活性，可以考虑在本地使用 gitbook-convert，然后用 Git 或 GitHub 新建一个仓库并导入转化后的内容。

我们很愿意帮忙解决你在使用 GitBook 时遇到的问题。你可以在 提问或标注一个问题。