# Présentation de l'éditeur (/fr/editor)

<!-- agent-signals: reading_time_min: 6 · est_tokens: 2711 · updated: 2026-09-23 -->

<Card title="Vous découvrez l'éditeur ? Commencez par le tutoriel." 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;M22 9V15&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M18 12V15.0669C18 16.1333 18 16.6665 17.737 17.1071L17.7316 17.1159C17.4661 17.5551 16.9843 17.8238 16.0206 18.3611C14.0645 19.4518 13.0864 19.9972 12.0109 20H11.9891C10.9136 19.9972 9.93551 19.4518 7.97941 18.3611C7.01574 17.8238 6.53391 17.5551 6.2684 17.1159L6.26305 17.1071C6 16.6665 6 16.1333 6 15.0669V12&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M8.52143 5.22252L4.40645 7.2074C2.80215 7.98124 2 8.36816 2 8.99125C2 9.61434 2.80215 10.0013 4.40645 10.7751L8.598 12.7969C10.2608 13.599 11.0922 14 11.9816 14C12.8711 14 13.7025 13.599 15.3653 12.7969L19.6386 10.7356C21.2141 9.97571 22.0018 9.59575 22 8.97064C21.9982 8.34553 21.2146 7.97321 19.6473 7.22857C18.2179 6.5494 16.8685 5.92516 15.433 5.24184C13.6907 4.41243 12.8195 3.99772 11.9353 4.00001C11.0512 4.00229 10.2079 4.40904 8.52143 5.22252Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/fr/editor/tutorial">
  Créez une branch, faites une modification, partagez un aperçu et publiez.
</Card>

Utilisez l'éditeur pour rédiger et publier de la documentation dans votre navigateur. L'éditeur repose sur un workflow docs-as-code dans lequel Git conserve toutes vos modifications. Votre travail est enregistré sous forme de commits dans votre dépôt et l'éditeur gère les opérations Git à votre place.

L'éditeur se charge par défaut lorsque vous ouvrez votre [dashboard](https://app.mintlify.com). Tout membre de votre organisation peut l'ouvrir, mais certaines actions dépendent de votre [rôle](/fr/dashboard/roles). Les admins et les editors peuvent modifier et publier. Les viewers peuvent parcourir le contenu et laisser des [commentaires et des suggestions](/fr/editor/collaborate).

<div id="how-the-editor-works">
  ## Fonctionnement de l'éditeur [#fonctionnement-de-léditeur]
</div>

**Les modifications sont enregistrées automatiquement, mais enregistrer n'est pas publier.** Au fur et à mesure que vous écrivez, l'éditeur enregistre votre travail. Vos modifications persistent d'un onglet, d'un appareil et d'une coupure réseau à l'autre. Pour qu'une modification atteigne votre site publié, vous devez la [publier](/fr/editor/publish).

**Publier écrit dans Git.** Lorsque vous publiez, l'éditeur commit vos modifications dans votre dépôt. Si vous publiez sur votre deployment branch, votre site publié est mis à jour immédiatement. Sur une feature branch, vos modifications sont commitées automatiquement sur la branch et ouvrent une pull request pour révision. Rien sur une feature branch n'atteint votre site publié tant qu'elle n'est pas fusionnée dans votre deployment branch.

**Git reste synchronisé.** Lorsque quelqu'un pousse des modifications vers votre dépôt, elles apparaissent automatiquement. Vous n'avez pas besoin de faire un pull ni d'actualiser. L'éditeur fusionne les modifications sans conflit et signale tout ce qui requiert votre attention.

**Votre équipe travaille ensemble.** Plusieurs personnes peuvent modifier la même page en même temps, avec des curseurs en direct qui montrent qui travaille où. Les commentaires et les suggestions sont visibles par tous.

<Tip>
  Si l'éditeur semble désynchronisé par rapport à votre dépôt, utilisez [Réinitialiser l'éditeur](/fr/editor/settings#reset-editor) pour forcer une resynchronisation.
</Tip>

<div id="editor-layout">
  ## Disposition de l'éditeur [#disposition-de-léditeur]
</div>

<Frame>
  <img src="/_assets/941c0fc71fcdefe2624848a0026d70aaae6bf64574fc1080df3f10372cceccfb" alt="Capture d'écran de l'éditeur avec l'onglet Site sélectionné." className="dark:hidden" />

  <img src="/_assets/f3bbe6e3f0fc4e59421abe42f1ab3bbe7a5b2556576a57902b54755949388f6d" alt="Capture d'écran de l'éditeur avec l'onglet Site sélectionné." className="hidden dark:block" />
</Frame>

* **Barre supérieure** : Ouvrez l'agent avec **Ask agent**. Sur l'onglet **Site**, la barre supérieure comporte également le sélecteur de branch, **Preview** et **Publish**. Sur l'onglet **Workspace**, elle comporte **Share**. Cliquez sur <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 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options** pour les actions de page comme **Page settings**, **Comments**, **Version history**, **Duplicate** et **Move to**.
* **Barre latérale** : Utilisez la barre latérale pour sélectionner les pages à modifier, créer de nouvelles pages et gérer la structure de votre site. Appuyez sur <kbd>Ctrl</kbd> + <kbd>\\</kbd> (macOS et Windows) pour la masquer ou l'afficher. Appuyez sur <kbd>Cmd</kbd> + <kbd>K</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>K</kbd> (Windows) pour rechercher dans vos pages et dans le dashboard.
  * **Workspace** : Pages qui ne font pas partie de votre dépôt Git ni de votre site publié. **Personal** contient vos brouillons privés, **Teamspace** contient les pages partagées avec toute votre organisation et **Shared with me** contient les pages que des collègues vous ont partagées directement.
  * **Site** : Votre dépôt et votre site publié. **Navigation** contient les pages présentes dans la navigation de votre site. **Files** liste les fichiers de votre dépôt qui ne figurent pas dans votre navigation.

<div id="visual-and-source-mode">
  ## Mode visuel et mode source [#mode-visuel-et-mode-source]
</div>

**Le mode visuel** affiche votre page au fur et à mesure que vous écrivez. Appuyez sur <kbd>/</kbd> pour ouvrir le menu des composants et en insérer.

**Le mode source** vous donne un accès direct au MDX, avec des numéros de ligne. Utilisez-le pour contrôler précisément les propriétés des composants et le frontmatter. Saisissez <kbd>\<</kbd> pour accéder aux composants. Appuyez sur <kbd>Cmd</kbd> + <kbd>S</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>S</kbd> (Windows) pour formater le document. Si une modification unique change plus de 1 000 caractères, l'éditeur vous demande de la confirmer.

Les deux modes modifient le même fichier et prennent en charge l'[édition en temps réel](/fr/editor/collaborate#real-time-editing). Passez de l'un à l'autre avec <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd> (Windows), ou avec le bouton **Source mode** dans <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 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options**. L'éditeur mémorise votre choix d'une page à l'autre.

Pour connaître les composants que vous pouvez insérer, consultez [Composants](/fr/components). Pour la syntaxe MDX, consultez [Mettre en forme le texte](/fr/create/text) et [Mettre en forme le code](/fr/create/code).

<div id="git-concepts">
  ## Notions de Git [#notions-de-git]
</div>

Comprendre quelques notions de Git vous aide à tirer le meilleur parti de l'éditeur. Pour les définitions des commits, branches, pull requests, merges, conflits et diffs, consultez [Concepts de Git pour la documentation](/fr/guides/git-concepts).

| Action dans l'éditeur                  | Opération Git                                                                                                                                                         |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Modifier une page                      | Enregistrement automatique. Pas encore de commit.                                                                                                                     |
| Publier sur votre deployment branch    | `git commit` et `git push`. Déclenche un déploiement.                                                                                                                 |
| Modifier sur une feature branch        | `git commit` et `git push` vers la branch environ 15 secondes après que vous arrêtez d'écrire. Le premier commit ouvre une pull request vers votre deployment branch. |
| Request review                         | Marque la pull request comme prête à être relue.                                                                                                                      |
| Merge and publish                      | Fusionne la pull request et déclenche un déploiement.                                                                                                                 |
| Créer une branch                       | `git checkout -b <branch-name>`                                                                                                                                       |
| Changer de branch                      | `git checkout <branch-name>`                                                                                                                                          |
| Push externe ou mise à jour via la CLI | Les modifications entrantes sont synchronisées dans l'éditeur via une fusion à trois voies.                                                                           |