> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Editor overview

> Create, edit, and publish content in your browser with real-time team collaboration, automatic saving, live previews, and continuous Git sync.

<Card title="New to the editor? Start with the tutorial." icon="graduation-cap" horizontal href="/editor/tutorial">
  A step-by-step walkthrough: create a branch, make a change, share a preview, and publish.
</Card>

## How the editor works

**Changes save automatically.** As you type, the editor saves your draft. Your work persists across tabs, devices, and network interruptions. Changes only go live when you publish them.

**Git stays in sync.** When someone else pushes changes to your repository from outside the editor, those changes appear in the editor automatically. You don't need to pull or refresh. The editor merges non-conflicting changes and highlights anything that needs your attention.

**Publishing writes to Git.** When you publish, the editor commits your changes to your repository. On a deployment branch, this updates your live site immediately. On a feature branch, it creates a pull request.

**Your team edits together.** Multiple people can edit the same page simultaneously. Live cursors show who is editing and where.

## The editor layout

<Frame>
  <img src="https://mintcdn.com/mintlify/yLHAwTnwTq05X1uS/images/editor/editor-layout-light.png?fit=max&auto=format&n=yLHAwTnwTq05X1uS&q=85&s=c77d11b14d15c8853724fb67afa2af13" alt="Screenshot of the editor showing the branch selector, ask agent button, publish button, navigation sidebar, and top bar." className="block dark:hidden" width="2537" height="420" data-path="images/editor/editor-layout-light.png" />

  <img src="https://mintcdn.com/mintlify/yLHAwTnwTq05X1uS/images/editor/editor-layout-dark.png?fit=max&auto=format&n=yLHAwTnwTq05X1uS&q=85&s=a8258f4b6fea8ac3310350cde8390208" alt="Screenshot of the editor showing the branch selector, ask agent button, publish button, navigation sidebar, and top bar." className="hidden dark:block" width="2537" height="420" data-path="images/editor/editor-layout-dark.png" />
</Frame>

* **Top bar**: Use the top bar to control what branch you work on, access the agent, preview, and publish changes.
* **Navigation sidebar**: Select a page to edit, create new pages, and manage the site structure.

## Explore the editor

<Card title="Branching and publishing" icon="git-branch" horizontal href="/editor/branching-and-publishing">
  How branches and protection rules determine what happens when you publish, and how to manage the pull request review process.
</Card>

<Card title="Ask agent" icon="sparkles" horizontal href="/editor/agent">
  Edit pages, search your content, modify settings, and configure your site from a chat interface.
</Card>

<Card title="Create and edit pages" icon="notebook-pen" horizontal href="/editor/pages">
  Add new and update existing pages.
</Card>

<Card title="Organize navigation" icon="list-tree" horizontal href="/editor/navigation">
  Reorder pages and manage site structure.
</Card>

<Card title="Live preview" icon="play" horizontal href="/editor/live-preview">
  Preview your site in real time as you edit without waiting for a build.
</Card>

<Card title="Configurations" icon="sliders-horizontal" horizontal href="/editor/configurations">
  Configure your site's branding, colors, and features.
</Card>

<Card title="Settings" icon="settings" horizontal href="/editor/settings">
  Configure AI instructions and publishing defaults for your deployment.
</Card>

<Card title="Git essentials" icon="git-merge" horizontal href="/editor/git-essentials">
  Understand the Git concepts behind the editor: branches, commits, pull requests, and merges.
</Card>

<Card title="Keyboard shortcuts" icon="keyboard" horizontal href="/editor/keyboard-shortcuts">
  Save time with keyboard shortcuts.
</Card>


## Related topics

- [API playground overview](/docs/api-playground/overview.md)
- [What is Mintlify?](/docs/what-is-mintlify.md)
- [Configurations](/docs/editor/configurations.md)