# 如何使用编辑器 (/zh/editor/tutorial)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 752 · updated: 2026-07-30 -->

本教程将引导你使用编辑器完成一次完整的内容更新。你将创建一个分支、进行更改、分享预览以供审查，然后发布你的更改。

<Steps>
  <Step title="Create a branch">
    分支是你内容的临时副本。这是你在不影响线上站点的情况下进行更改的地方。你可以将分支合并到线上站点，或在选择不进行更改时安全地丢弃它。

    在分支上工作可以让你的编辑与线上站点保持隔离，直到你准备好与用户分享内容为止。

    1. 在编辑器工具栏中，点击分支名称（通常为 `main`）。
       <Frame>
         <img src="/_assets/17722a391e0089ff57e2ea13efa88a05aa02737adf1007a65ef8a64e0c33bb26" alt="编辑器工具栏中突出显示的分支名称。" className="block dark:hidden" />

         <img src="/_assets/800c6e370347f2aecbb64547fcf893bbc3af053e0d266073595c2e03f0035c8b" alt="编辑器工具栏中突出显示的分支名称。" className="hidden dark:block" />
       </Frame>
    2. 点击 **Create new branch**。
    3. 输入一个描述你的更改的名称，例如 `update-quickstart`。
    4. 点击 **Create branch**。

    编辑器会切换到你的新分支。你所做的任何更改都只在该分支上。只有在你完成发布流程后，它们才会出现在你的线上站点上。
  </Step>

  <Step title="Make your changes">
    编辑现有页面或创建新页面。

    **编辑页面**：点击导航侧边栏中的页面名称将其打开。直接在编辑器中输入以添加内容。按下 <kbd>/</kbd> 可插入组件、图片或其他内容。

    **创建页面**：点击你想要添加页面的导航分组旁边的 <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12.001 5.00003V19.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M19.002 12.002L4.99998 12.002&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> 加号按钮，然后点击 **Add a page** 并输入文件名。

    <Frame>
      <img src="/_assets/f47ee86e58130d31ac32025b41844b41994767340a2a5945b1f4cf12093fba05" alt="在编辑器中某个分组旁打开的添加页面菜单。" className="block dark:hidden" />

      <img src="/_assets/59890ba1296fb5bf1d5e8ba00723aa0a411303d1f351ada93bbabf452e3dd6e1" alt="在编辑器中某个分组旁打开的添加页面菜单。" className="hidden dark:block" />
    </Frame>
  </Step>

  <Step title="Publish your branch">
    当你准备好接受审查时，从你的分支创建一个拉取请求。拉取请求是一个将你的更改合并到构建线上站点的分支的提议。只有在有人批准并合并拉取请求后，你的更改才会上线。

    1. 点击工具栏中的 **Publish** 以打开发布菜单。
       <Frame>
         <img src="/_assets/6a93664d41b6b76b5f5edefe683e8b2ffe5f903e84ed58c3db3247e110a10d0d" alt="在编辑器工具栏中打开的发布菜单。" className="block dark:hidden" />

         <img src="/_assets/d720a56afe160ee5692808f1c977251fd276081380107b1042c12bf8bf716543" alt="在编辑器工具栏中打开的发布菜单。" className="hidden dark:block" />
       </Frame>
    2. 可选：点击列表中任意已更改的文件，查看并将你的编辑与已发布版本进行对比。
    3. 点击 **Create pull request**。添加标题和描述，然后点击 **Publish pull request**。

    <Note>
      你也可以点击 **Save in branch**，先提交你的更改而不立即打开拉取请求。如果你想在请求审查之前继续编辑，这会很有用。
    </Note>

    创建拉取请求后，预览部署会自动构建。发布菜单会显示预览 URL——一个临时链接，你的更改会在那里以线上站点上的样子完全呈现。将此 URL 分享给你的审查者。
  </Step>

  <Step title="Get your pull request approved">
    将拉取请求分享给你的团队。审查者可以在 GitHub 或 GitLab 中打开拉取请求，留下评论、请求更改或批准它。

    如果审查者请求更改，请在同一分支上的编辑器中进行编辑。你的更新会自动推送到现有的拉取请求。你不需要创建新的。

    当所有必需的审查者都批准后，拉取请求即可合并。
  </Step>

  <Step title="Merge and publish">
    在拉取请求获得批准后，点击工具栏中的 **Publish** 以重新打开发布菜单。该菜单现在会显示拉取请求的状态以及合并选项。

    点击 **Merge and publish**。编辑器会合并拉取请求，并将你切换回部署用分支。Mintlify 会构建并部署你的更改。你的线上站点会在大约 30 秒到几分钟内更新。
  </Step>
</Steps>