# Collaborer dans l'éditeur (/fr/editor/collaborate)

<!-- agent-signals: reading_time_min: 6 · est_tokens: 2170 · updated: 2026-09-23 -->
Related: [Comment utiliser l'éditeur](/fr/editor/tutorial.md), [Créer et modifier des pages](/fr/editor/pages.md), [Publier des modifications](/fr/editor/publish.md), [Réviser les modifications](/fr/editor/review.md), [Interroger l'agent](/fr/editor/agent.md), [Paramètres de l'éditeur pour l'IA et la publication](/fr/editor/settings.md)

Travaillez avec votre équipe sur une page en la commentant, en y proposant des suggestions ou en la modifiant ensemble en même temps.

<div id="comments">
  ## Commentaires [#commentaires]
</div>

<Info>
  Tous les [rôles](/fr/dashboard/roles) peuvent commenter, répondre et résoudre les fils.
</Info>

Les commentaires vous permettent de laisser un retour sur un texte précis sans modifier le contenu.

**Les commentaires n'atteignent jamais votre dépôt.** Ils n'existent que dans l'éditeur et ne sont jamais inclus dans le site publié ni commités dans Git. Si votre branch comporte une pull request ouverte, Mintlify ajoute à sa description un résumé des fils non résolus, avec un lien vers chaque commentaire. Le résumé se met à jour au fil des changements.

Pour ajouter un commentaire, surlignez du texte et cliquez sur l'icône <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 20.5C19.1328 20.5 22 16.4706 22 11.5C22 6.52944 20.1328 2.5 12 2.5C4.13281 2.5 2 6.52944 2 11.5C2 13.5712 2.37034 15.4791 3.37161 17C4.63281 19 3.99253 20.8333 3 21.5C4.61547 21.5 5.70211 20.9858 6.39239 20.4766C6.88252 20.115 7.50688 19.9364 8.0984 20.0815C9.20689 20.3533 10.4991 20.5 12 20.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12.1248 11.5H11.9998M16.125 11.5H16M8.125 11.5H8M12.2498 11.5C12.2498 11.6381 12.1379 11.75 11.9998 11.75C11.8618 11.75 11.7498 11.6381 11.7498 11.5C11.7498 11.3619 11.8618 11.25 11.9998 11.25C12.1379 11.25 12.2498 11.3619 12.2498 11.5ZM16.25 11.5C16.25 11.6381 16.1381 11.75 16 11.75C15.8619 11.75 15.75 11.6381 15.75 11.5C15.75 11.3619 15.8619 11.25 16 11.25C16.1381 11.25 16.25 11.3619 16.25 11.5ZM8.25 11.5C8.25 11.6381 8.13807 11.75 8 11.75C7.86193 11.75 7.75 11.6381 7.75 11.5C7.75 11.3619 7.86193 11.25 8 11.25C8.13807 11.25 8.25 11.3619 8.25 11.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **Comment** dans la barre d'outils, ou appuyez sur <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd> (Windows).

<Frame>
  <img src="/_assets/5f3a7d200ec813d19b910c5e46c4b6748fc574909296ae1929b652275925fbc8" alt="Le bouton de commentaire dans la barre d'outils flottante au-dessus du texte sélectionné dans l'éditeur." className="dark:hidden" />

  <img src="/_assets/ebcb9c5b53a3a0a99e26de42e148addddfa55c4eb0079ce2259788e8fd216d6d" alt="Le bouton de commentaire dans la barre d'outils flottante au-dessus du texte sélectionné dans l'éditeur." className="hidden dark:block" />
</Frame>

Saisissez `@` pour mentionner un collègue dans un commentaire. Il doit être membre de votre organisation et avoir accepté son invitation. Lorsque vous mentionnez un collègue dans un commentaire, il reçoit une notification par e-mail. Gérez les e-mails de commentaires et de suggestions que vous recevez depuis la page [Notifications](/fr/dashboard/notifications) de votre dashboard.

Les fils de commentaires apparaissent aussi bien en mode visuel qu'en mode source. En mode source, vous pouvez lire, répondre et résoudre les fils existants, mais démarrer un nouveau commentaire nécessite le mode visuel.

Pour voir tous les fils de la page actuelle :

1. 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** en haut à droite de la page.
2. Cliquez sur **Comments**.

Réagissez à un commentaire pour en prendre acte sans répondre. Survolez un commentaire, cliquez sur le bouton **Add reaction** et choisissez un emoji. Réagir au commentaire de quelqu'un d'autre envoie une notification à l'auteur du commentaire.

Pour modifier ou supprimer un commentaire que vous avez écrit, cliquez sur **More actions** sur le commentaire. Vous ne pouvez modifier et supprimer que vos propres commentaires. Supprimer le premier commentaire d'un fil supprime le fil entier.

<div id="suggestions">
  ## Suggestions [#suggestions]
</div>

Les suggestions proposent une modification tout en conservant le contenu actuel, de sorte qu'un collègue puisse l'accepter ou la refuser.

Les editors et les admins peuvent accepter ou refuser n'importe quelle suggestion. Les viewers ne le peuvent pas.

Pour faire une suggestion, surlignez du texte et cliquez sur **Switch to suggesting** dans la barre d'outils, ou appuyez sur <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>E</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>E</kbd> (Windows). En mode suggestion, un libellé **Suggesting** apparaît dans la barre supérieure, et vos suppressions et insertions apparaissent en surbrillance plutôt que comme des modifications. Cliquez sur le libellé pour revenir en mode édition. Les suggestions en attente apparaissent à côté de la page et dans le panneau des commentaires.

<Note>
  Les [viewers](/fr/dashboard/roles) sont toujours en mode suggestion. Le mode suggestion s'active automatiquement quand un viewer ouvre l'éditeur, afin qu'il puisse proposer des modifications sans modifier directement le contenu.
</Note>

Cliquez sur une suggestion surlignée, puis sur **Accept suggestion** ou **Reject suggestion**. Dans les deux cas, le fil de la suggestion est résolu. Une modification acceptée fait partie de votre branch actuelle et est mise en ligne la prochaine fois que vous [publiez](/fr/editor/publish).

<div id="ask-the-mintlify-agent">
  ## Interroger l'agent Mintlify [#interroger-lagent-mintlify]
</div>

Mentionnez `@mintlify` dans un commentaire, une suggestion ou une réponse pour interroger l'[agent de l'éditeur](/fr/editor/agent) au sujet de la page en cours. L'agent s'exécute en arrière-plan avec la page, le fil et la branch comme contexte, puis publie sa réponse dans le même fil.

```text
@mintlify does this endpoint support pagination?
@mintlify are there any pages that contradict this?
```

L'agent fonctionne en lecture seule lorsqu'il répond à des commentaires. Il peut faire des recherches dans votre documentation, lire des pages, consulter du contenu web et charger des skills, mais il ne peut ni modifier le contenu, ni créer des suggestions, ni publier. Pour apporter des modifications, ouvrez directement l'[agent de l'éditeur](/fr/editor/agent).

Les mentions fonctionnent sur les pages privées pour les membres qui y ont déjà accès.

<div id="real-time-editing">
  ## Édition en temps réel [#édition-en-temps-réel]
</div>

Lorsque plusieurs personnes ouvrent la même page sur la même branch, elles la modifient ensemble. Le curseur et les modifications de chacun sont visibles par tous, avec des avatars dans la barre d'outils.

L'édition en temps réel fonctionne aussi bien en mode visuel qu'en mode source. Vous pouvez modifier le MDX en mode source pendant qu'un collègue travaille en mode visuel sur la même page. Son curseur et sa sélection apparaissent dans votre éditeur, et les vôtres apparaissent dans le sien, y compris dans les champs de titre et de description.

* Les modifications de tous les collaborateurs fusionnent automatiquement. Deux personnes qui modifient la même section ne créent pas de conflit.
* L'annulation n'affecte que vos propres modifications.
* Si vous perdez la connexion, vos modifications sont enregistrées localement et synchronisées à la reconnexion.
* En mode source, un MDX non valide ou un frontmatter YAML non valide reste local à votre poste tant que vous ne l'avez pas corrigé. Vos collègues ne reçoivent que du contenu valide, et un MDX non valide [empêche la publication](/fr/editor/publish#invalid-mdx-blocks-publishing) tant qu'il n'est pas corrigé.

Lorsque l'[agent Mintlify](/fr/agent) modifie une page via l'API ou MCP, il apparaît comme n'importe quel autre collaborateur, avec un avatar et un curseur en direct sur sa modification la plus récente. Le curseur disparaît quand l'agent a terminé.