快速入门
在 GitBook 中快速上手，并在几分钟内发布你的第一个文档站点
本快速入门指南将介绍如何在 GitBook 中完成设置，并在几分钟内发布你的第一个文档网站。
在本指南结束时，你将拥有一个已上线的文档网站，可随时扩展和自定义。
创建你的账户
创建账户 以开始创建你的第一个文档网站。
编辑你的内容
文档模板会在 内容 侧边栏部分为你提供占位版块。点击任意版块即可打开并查看其占位内容。
在 GitBook 中编辑和更新内容有两种方式——使用可视化编辑器，或遵循 docs-as-code 工作流。 你可以选择其中一种，也可以两者结合使用。 无论你偏好哪种工作流，你都将使用 基于分支的编辑流程进行编辑。了解更多请参见 概念页面.
GitBook 的所见即所得（WYSIWYG）编辑器可让你以可视化方式编辑内容、拖动内容块重新排序，并在工作时实时查看内容效果。如果你不想在代码编辑器中操作，或者你已经习惯了 Notion 或 Google Docs 之类的工具，它就非常适合你。
在变更请求中编辑你的文档
在 内容 侧边栏部分，点击某个版块（例如“文档”）将其打开。
点击 编辑 位于右上角。这会打开一个变更请求，你可以在其中修改该版块的内容。
点击 添加新内容… > 页面 在左侧目录中。
给你的新页面添加标题。
预览你的更改
在网页应用顶部，你会看到以下标签： 编辑器, “更改”，以及 预览。这些标签可在内容的不同视图之间切换。点击 预览 即可查看你的文档网站在变更请求中的所有更改应用后，在桌面和移动设备上的显示效果。
合并你的更改
当你对更改满意后，点击 合并 右上角的按钮。这会将变更请求中的所有编辑更新到你内容的主版本。如果内容属于一个已上线的文档网站，网站会立即更新。
将你的文档与 GitHub 或 GitLab 仓库同步，以便在你现有的开发环境中启用基于代码的编辑。它非常适合喜欢将文档与其他代码一起管理的技术用户。
设置 Git 同步
从 内容 侧边栏部分打开你要同步的版块。
点击 Git 同步指示器的 设置 顶部栏按钮。
按照说明将该版块同步到你选择的 Git 仓库。前往 Git 同步页面 了解更多。
在你的开发环境中编辑文档
将你的版块同步到 Git 仓库后：
打开该仓库。
创建拉取请求。
进行你想要的更改。
GitBook 支持 Markdown 编辑，因此你可以使用常见语法创建并格式化内容。
GitBook 中的每个标准块都可以使用 Markdown 编写和格式化。
预览你的更改
你可以 预览你的更改 在你已发布的文档网站上通过 GitHub 或 GitLab 中的拉取请求进行预览。你的拉取请求会显示一个带有唯一预览 URL 的状态。点击 详情 即可打开该状态并查看合并后的站点效果。
合并你的更改
合并你的拉取请求后，你的内容更新会同时反映在 GitBook 应用中，并在你的文档网站（如果已上线）中生效。在 GitBook 应用中，每次提交以及你合并后的拉取请求都会作为更新同步到你的版块版本历史中。
发布你的文档
你可以随时一键发布你的网站。
从你的组织中打开你的网站 主页.
点击 发布 在网站页眉中。
网站上线后， 概览 屏幕会更新为指向线上网站的链接。
想更深入了解发布吗？请查看 我们关于在 GitBook 中创建和发布内容的完整指南.
添加自定义域名
默认情况下，你的网站会以如下格式使用唯一 URL 发布：
https://[organization-name].gitbook.io/[site-title]展开 设置 在你网站的侧边栏中。
点击 域名和 URL.
选择你想要的选项。
按照说明在你的域名提供商处配置 DNS 设置。
DNS 更改最多可能需要 48 小时才会生效——不过通常传播速度会快得多。
下一步
最后更新于
这有帮助吗？