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

<!-- agent-signals: reading_time_min: 1 · est_tokens: 714 · updated: 2026-09-23 -->
Related: [创建和编辑页面](/zh/editor/pages.md), [发布更改](/zh/editor/publish.md), [审阅更改](/zh/editor/review.md), [在编辑器中协作](/zh/editor/collaborate.md), [询问智能体](/zh/editor/agent.md), [编辑器的 AI 与发布设置](/zh/editor/settings.md)

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

<Steps>
  <Step title="创建分支">
    分支是你内容的临时副本。你可以在其中进行更改，而不会影响你的线上站点。你可以把分支合并到线上站点，也可以在决定不进行更改时安全地丢弃它。

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

    1. 在编辑器工具栏中，点击分支名称（通常为 `main`，带有 **Live** 徽章）。如果看不到它，请[显示分支选择器](/zh/editor/publish#show-the-branch-selector)。
       <Frame>
         <img src="/_assets/bf51e2362f1e2e0da4fd2b42ec73ef0dfe28e2dac4c23284d0d724f52eecd6b7" alt="编辑器工具栏中突出显示的分支名称。" className="block dark:hidden" />

         <img src="/_assets/0ba261353886d412e1f0ab56a000d7751e1593e83b19c4328acdb3ba495c5e27" alt="编辑器工具栏中突出显示的分支名称。" className="hidden dark:block" />
       </Frame>
    2. 在 **Find a branch** 中输入描述你更改的标题，例如 `Update quickstart`。
    3. 点击 **New branch**。

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

  <Step title="进行更改">
    编辑现有页面或创建新页面。

    **编辑页面**：点击导航侧边栏中的页面名称将其打开。直接在编辑器中输入以添加内容。按 <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>" /> 加号按钮，然后点击 **New page**。为页面输入标题。编辑器会以该标题命名文件。

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

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

  <Step title="发布你的分支">
    首次编辑分支时，编辑器会为其打开一个 pull request。pull request 是把你的更改合并到构建你线上站点的分支的提议。只有在 pull request 合并之后，你的更改才会上线。

    准备好接受审阅后，可以从发布菜单请求审阅。

    1. 点击工具栏中的 **Publish** 以打开发布菜单。
    2. 可选：点击列表中任意已更改的文件，查看并将你的编辑与已发布版本进行对比。
    3. 点击 **Request review**。

    Mintlify 会为你的 pull request 构建[预览部署](/zh/editor/review#preview-deployments)：一个临时链接，你的更改在其中的渲染效果与线上站点上完全一致。你可以在 Mintlify 机器人的 pull request 评论中找到该 URL，并将其分享给你的审阅者。
  </Step>

  <Step title="让你的 pull request 获得批准">
    将 pull request 分享给你的团队。若要打开它，请点击发布菜单中的 **View request**。审阅者可以在 GitHub、GitLab 或 Bitbucket 中打开 pull request，留下评论、请求更改或批准它。

    如果审阅者请求更改，请在同一分支上的编辑器中进行编辑。你的更新会自动提交到现有的 pull request，无需创建新的。

    当所有必需的审阅者都批准后，pull request 即可合并。
  </Step>

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

    点击 **Merge and publish**。如果 Mintlify 托管你的仓库并且不要求审批，该按钮会显示为 **Publish**。编辑器会合并 pull request，并把你切换回 deployment branch。Mintlify 会构建并部署你的更改。你的线上站点会在大约 30 秒到几分钟内更新。
  </Step>
</Steps>