# Créer et modifier des pages (/fr/editor/pages)

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

<div id="workspace-and-site">
  ## Workspace et Site [#workspace-et-site]
</div>

La barre latérale de l'éditeur comporte deux onglets : **Workspace** et **Site**.

**Workspace** contient les pages qui ne font pas partie de votre dépôt Git ni de votre site publié. Les pages du workspace sont enregistrées automatiquement et n'ont pas d'étape de publication.

* **Recents** : Pages du workspace que vous avez ouvertes récemment.
* **Starred** : Pages du workspace que vous avez marquées d'une étoile. Pour marquer une page d'une étoile, ouvrez son menu d'options et sélectionnez **Star**. Les étoiles vous sont personnelles.
* **Personal** : Vos [pages privées](#private-pages).
* **Teamspace** : Pages partagées avec toute votre organisation. Consultez [Teamspace](#teamspace).
* **Shared with me** : Pages que des collègues [vous ont partagées](#share-a-private-page) directement.

**Site** contient votre dépôt et les pages que vos visiteurs voient sur votre site publié.

* **Navigation** : Les pages et groups présents dans la navigation de votre site, tels que définis dans `docs.json`.
* **Files** : Tous les fichiers de votre dépôt qui ne figurent pas dans votre navigation, y compris les images, les vidéos, les spécifications OpenAPI et `docs.json`.

Recents, starred et shared with me n'apparaissent que lorsqu'ils contiennent quelque chose.

Faites glisser un en-tête de section pour réordonner les sections d'un onglet. Cliquez sur un en-tête de section pour la réduire ou la développer. L'éditeur enregistre l'ordre des sections et leur état de réduction dans votre compte.

Changer d'onglet réouvre la dernière page que vous avez consultée sur cet onglet. La barre supérieure change avec l'onglet. **Share** n'apparaît que sur **Workspace**. Le sélecteur de branch, **Preview** et **Publish** n'apparaissent que sur **Site**.

<div id="create-a-page">
  ## Créer une page [#créer-une-page]
</div>

Pour créer une page, cliquez sur le bouton <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>" /> plus à l'endroit souhaité, puis sélectionnez **New page**.

* En-tête de la section **Navigation** : Ajoute une nouvelle page à la fin de votre navigation.
* Un group ou un autre élément de navigation : Ajoute une nouvelle page à l'intérieur de cet élément.
* En-tête de la section **Files** ou dossier dans **Files** : Crée un fichier qui n'est pas dans votre navigation.

Le bouton **New page** en bas de l'onglet **Site** ajoute lui aussi une page à la fin de votre navigation.

<Tip>
  Pour ajouter à votre navigation une page qui existe déjà dans votre dépôt, cliquez sur le bouton <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>" /> plus et sélectionnez **Add existing page**.
</Tip>

Les mêmes menus créent des éléments de navigation comme des groups, tabs, anchors, dropdowns, versions, languages et products. Pour plus d'informations sur chaque élément, consultez [Navigation](/fr/organize/navigation).

<div id="edit-page-settings">
  ## Modifier les paramètres d'une page [#modifier-les-paramètres-dune-page]
</div>

Définissez le titre, la description et l'icône d'une page directement en haut de la page. Survolez le titre et cliquez sur **Add icon** pour choisir une icône ou un emoji. Lorsqu'une page avec une icône est ouverte, votre onglet de navigateur affiche cette icône.

Pour les autres paramètres, ouvrez le menu d'options de la page dans la barre latérale, ou 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, puis sélectionnez **Page settings**. Le panneau **Page settings** regroupe les paramètres en sections :

* **URL** : Le chemin et l'URL de redirection de la page. Modifier le chemin déplace le fichier.
* **Navigation** : Titre dans la barre latérale, tag, mode et si la page est masquée.
* **SEO & sharing** : Image Open Graph et mots-clés.

Les groups, tabs et autres éléments de navigation ont leurs propres panneaux de paramètres, comme **Group settings** et **Tab settings**. Ouvrez-les depuis le menu d'options de l'élément. Consultez [Pages](/fr/organize/pages) pour plus d'informations sur les paramètres spécifiques.

<div id="add-media">
  ## Ajouter des médias [#ajouter-des-médias]
</div>

Saisissez <kbd>/image</kbd> ou <kbd>/video</kbd> pour téléverser un fichier ou en choisir un déjà présent dans votre dépôt. Vous pouvez aussi faire glisser des fichiers depuis votre ordinateur sur la page, ou faire glisser une image ou une vidéo depuis la section **Files** sur la page.

* Les fichiers téléversés sont enregistrés dans vos dossiers `images/`, `videos/` et `files/` et sont inclus dans le commit de votre prochaine publication. Avant d'insérer un fichier téléversé, vous pouvez modifier son chemin.
* Vous pouvez téléverser des images PNG, JPG, GIF, WebP, AVIF, ICO et BMP, des vidéos MP4, WebM et MOV, ainsi que des fichiers PDF. Les fichiers SVG ne peuvent pas être téléversés dans l'éditeur.
* Chaque fichier téléversé peut atteindre 20 Mo.
* Pour afficher une image différente en mode sombre, sélectionnez l'image, cliquez sur **Edit Image**, puis définissez **Dark mode image**.
* Saisissez <kbd>/embed</kbd> pour ajouter une intégration. Sur l'onglet **Video link**, collez une URL YouTube, Loom ou Vimeo, ou un lien direct vers un fichier vidéo. Sur l'onglet **Embed code**, collez un iframe ou un autre extrait d'intégration.

Pour la mise en forme des images et l'utilisation du composant Frame, consultez [Images et intégrations](/fr/create/image-embeds).

<div id="organize-navigation">
  ## Organiser la navigation [#organiser-la-navigation]
</div>

Faites glisser des éléments dans **Navigation** pour les réordonner ou les imbriquer. L'éditeur écrit vos modifications dans `docs.json` lorsque vous publiez.

<Note>
  Certains éléments ne peuvent pas être imbriqués dans d'autres. Par exemple, les tabs ne peuvent pas être imbriqués dans des groups. L'éditeur empêche les combinaisons non valides.
</Note>

Pour sélectionner plusieurs éléments, faites <kbd>Shift</kbd>+clic pour sélectionner une plage. Faites glisser la sélection ou faites un clic droit dessus pour déplacer, dupliquer ou supprimer d'un seul coup tous les éléments sélectionnés. Appuyez sur <kbd>Esc</kbd> pour désélectionner.

Pour transformer un group ou un autre élément en un type différent, ouvrez son menu d'options et sélectionnez **Convert to**.

Les éléments de navigation globaux, comme les anchors et tabs qui apparaissent dans toutes les sections de votre site, ne figurent pas dans l'arborescence de la barre latérale. Pour les gérer, cliquez sur **Site settings** en bas de l'onglet **Site**, puis allez dans **Navigation**.

<div id="add-and-remove-pages-from-your-navigation">
  ### Ajouter et retirer des pages de votre navigation [#ajouter-et-retirer-des-pages-de-votre-navigation]
</div>

Faites glisser une page depuis **Files** dans **Navigation** pour l'ajouter à cette position. Faites glisser un dossier pour l'ajouter comme group. Vous pouvez aussi sélectionner **Move to navigation** depuis le menu d'options d'un fichier.

Pour retirer une page ou un group de votre navigation sans supprimer ses fichiers, faites-le glisser depuis **Navigation** dans **Files**, ou sélectionnez **Move to files** dans son menu d'options. Un toast d'annulation apparaît après le déplacement.

<div id="files">
  ## Files [#files]
</div>

Cliquez sur un fichier dans **Files** pour l'ouvrir.

* Les images s'ouvrent dans un aperçu. Cliquez sur l'image pour zoomer.
* Les vidéos se lisent dans l'éditeur.
* `docs.json` s'ouvre en mode source.
* Les fichiers texte et de code, comme YAML, JSON et CSS, s'ouvrent dans l'éditeur source.
* Les autres fichiers, comme les polices et les archives, ne peuvent pas être prévisualisés dans l'éditeur.

Pour téléverser des fichiers, faites-les glisser depuis votre ordinateur dans la section **Files**.

<div id="move-a-page">
  ## Déplacer une page [#déplacer-une-page]
</div>

Pour déplacer une page dans un autre dossier, ouvrez son menu d'options et sélectionnez **Move to**, ou appuyez sur <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (Windows) lorsque la page est ouverte.

Vous pouvez ouvrir le menu d'options d'une page depuis :

* <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 d'une page ouverte.
* Le menu <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>" /> à côté d'une page dans la barre latérale.
* Un clic droit sur une page dans la barre latérale.

Dans le sélecteur, recherchez pour filtrer les dossiers, développez les dossiers pour voir les destinations imbriquées et sélectionnez un dossier pour déplacer la page. Le dossier actuel est marqué **Current** et ne peut pas être sélectionné. Un toast avec **Revert** apparaît après le déplacement.

Déplacer une page du site déplace son fichier dans le nouveau dossier. Les editors et les admins peuvent déplacer les pages du site. Vous pouvez déplacer les pages du workspace que vous gérez dans **Personal** et **Teamspace**, mais pas les pages dans **Shared with me**.

<div id="delete-a-page">
  ## Supprimer une page [#supprimer-une-page]
</div>

Pour supprimer une page, 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, puis sur **Move to trash**. Vous pouvez aussi supprimer une page depuis son menu d'options dans la barre latérale.

Supprimer une page du site supprime à la fois le fichier et son entrée de navigation. Un toast avec **Undo** apparaît après la suppression. Pour retirer une page de votre navigation sans supprimer son fichier, sélectionnez plutôt **Move to files**.

Supprimer une page du workspace est définitif. Pour les pages du workspace, le menu **More options** affiche **Delete page**.

Les editors et les admins peuvent supprimer les pages du site.

<div id="version-history">
  ## Historique des versions [#historique-des-versions]
</div>

L'historique des versions vous permet de comparer une page avec ses versions enregistrées antérieures et d'en restaurer une. Il n'est pas disponible pour `docs.json`.

L'éditeur enregistre une nouvelle entrée dès que le contenu diffère de la dernière version enregistrée. L'historique des versions est limité à la branch. Seul l'historique de la branch actuelle est disponible.

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, puis sur **Version history**.
2. Sélectionnez une version. L'éditeur montre en quoi la page actuelle diffère de cette version.
3. Pour la restaurer, cliquez sur **Restore this version**, puis confirmez.

Pour quitter la comparaison, cliquez sur **Exit comparison** ou appuyez sur <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd> (Windows).

Tout le monde peut comparer les versions. Les editors et les admins peuvent restaurer les versions des pages du site. Pour les pages du workspace, vous avez besoin du rôle **Editor** ou **Publisher** sur la page pour restaurer une version.

Restaurer une version remplace le contenu actuel de la page. Lorsque vous restaurez une page du site, elle n'est restaurée que sur votre branch actuelle. Lorsque vous restaurez une page du workspace, elle est restaurée sur toutes les branches.

<div id="private-pages">
  ## Pages privées [#pages-privées]
</div>

Les pages privées sont des brouillons qui se trouvent dans la section **Personal** de l'onglet **Workspace**. Elles vous sont privées, ne sont pas commitées dans votre dépôt et n'apparaissent jamais sur votre site publié tant que vous ne les déplacez pas dans votre site.

Pour créer une page ou un dossier privé, cliquez sur le bouton <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>" /> plus sur l'en-tête de la section **Personal**, puis sélectionnez **New page** ou **New folder**. Le bouton **New page** en bas de l'onglet **Workspace** crée lui aussi une page privée.

Pour définir une icône ou un emoji sur un dossier du workspace, ouvrez son menu d'options et sélectionnez **Change icon**. Choisissez une icône dans l'onglet **Icons** ou un emoji dans l'onglet **Emojis**, ou sélectionnez **Remove** pour l'effacer.

<div id="share-a-private-page">
  ### Partager une page privée [#partager-une-page-privée]
</div>

Pour partager une page privée, ouvrez-la et cliquez sur **Share** dans la barre supérieure. Pour partager un dossier, ouvrez son menu d'options dans la barre latérale et sélectionnez **Share**. Recherchez des collègues et attribuez un rôle à chacun :

* **Publisher** : Modifier, relire et publier.
* **Editor** : Créer et modifier du contenu.
* **Viewer** : Consulter le contenu uniquement.

Sous l'accès général, choisissez **Only people invited** ou **Everyone at** votre organisation. Seuls les Publishers peuvent modifier qui a accès.

Les pages qui vous sont partagées apparaissent dans **Shared with me**. Pour retirer une page de votre barre latérale, ouvrez son menu d'options et sélectionnez **Leave**.

<div id="teamspace">
  ## Teamspace [#teamspace]
</div>

Les pages du teamspace sont accessibles à toute votre organisation. Comme les pages privées, elles ne sont pas commitées dans votre dépôt. L'accès dépend de votre [rôle](/fr/dashboard/roles). Les editors et les admins peuvent modifier et gérer les pages du teamspace, et les viewers peuvent les lire. Comme tout le monde y a déjà accès, vous ne pouvez pas partager individuellement les pages du teamspace.

Pour créer une page ou un dossier du teamspace, cliquez sur le bouton <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>" /> plus sur l'en-tête de la section **Teamspace**, puis sélectionnez **New page** ou **New folder**.

Pour déplacer une page privée dans le teamspace, faites-la glisser depuis **Personal** dans **Teamspace**, ou ouvrez son menu d'options, sélectionnez **Move to** et choisissez **Teamspace**. Vous pouvez déplacer des pages, mais pas des dossiers.

<div id="move-a-page-to-your-site">
  ## Déplacer une page vers votre site [#déplacer-une-page-vers-votre-site]
</div>

Pour publier une page personal ou teamspace, ouvrez son menu d'options dans la barre latérale et sélectionnez **Move to site**. La page est déplacée dans votre navigation, et la barre latérale bascule sur **Site** et la met en évidence. Déplacer un dossier l'ajoute à votre navigation comme un group, avec toutes ses pages et son icône.

<Warning>
  Déplacer des pages entre sections est à sens unique. Vous ne pouvez pas déplacer une page depuis **Teamspace** vers **Personal**, ni depuis **Site** vers **Workspace**.
</Warning>