> For the complete documentation index, see [llms.txt](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/getting-started/import.md).
# Migrer vers GitBook
Vous pouvez migrer et unifier la documentation existante dans GitBook à l’aide de l’outil d’importation.
Vous avez la possibilité d’importer des pages individuelles ou multiples à l’aide de notre outil d’importation intégré — ou [un dépôt Git entier à l’aide de Git Sync](#import-using-git-sync).
## Utilisation du panneau d’importation
Le panneau d’importation facilite la migration de votre contenu vers votre organisation GitBook depuis un autre site de documentation ou depuis des fichiers existants.
Lorsque vous choisissez d’importer depuis un autre site de documentation en ligne, il vous suffit d’ajouter l’URL du site et GitBook s’occupe du reste.
Par défaut, GitBook utilise l’IA pour simplifier le processus d’importation. Celle-ci affinera et nettoiera intelligemment le contenu importé qui ne correspond pas parfaitement aux formats de GitBook — ce qui signifie que le résultat sera plus soigné et utilisera plus efficacement les blocs GitBook. Vous pouvez désactiver cette option depuis le menu.
### Formats d’importation pris en charge
GitBook prend en charge les importations depuis des sites de documentation ou des fichiers aux formats suivants :
* Markdown (`.md` ou `.markdown`)
* HTML (`.html`)
* Microsoft Word (`.docx`)
GitBook prend également en charge les importations depuis :
* Confluence
* Notion
* GitHub Wiki
* Quip
* Dropbox Paper
* Google Docs
Si vous souhaitez **importer plusieurs pages**, vous pouvez téléverser un fichier ZIP contenant des fichiers HTML ou Markdown, ou utiliser l’option **Documentation en ligne** d’importation.
{% hint style="info" %}
GitBook est basé sur Markdown, donc l’importation de contenu au format Markdown donnera les meilleurs résultats. Si vos outils actuels prennent en charge l’exportation en Markdown, nous vous recommandons d’utiliser ce format pour un processus d’importation plus fluide.
{% endhint %}
### Le panneau d’importation
Le panneau d’importation dans GitBook.
Lorsque vous créez un nouvel espace, vous aurez la possibilité d’importer du contenu dans la fenêtre modale qui apparaît. Si vous créez un espace vide, vous pouvez également importer à l’aide de la **Démarrage rapide** section en bas de la nouvelle page vide lorsque vous cliquez sur **Modifier**.
Sinon, vous pouvez toujours importer une page ou une sous-page en sélectionnant **Ajouter nouveau** > **Importer des pages** en bas de la [table des matières](/url/gitbook.com/docs/documentation/fr/ressources/gitbook-ui.md#table-of-contents), ou en ouvrant le **menu Actions** pour une page et en choisissant **Importer des sous-pages**.
Après avoir choisi une source d’entrée, vous pouvez sélectionner le fichier que vous souhaitez importer.
{% hint style="warning" %}
GitBook importe du contenu depuis diverses sources, mais les différences entre les fonctionnalités du produit et les formats de document peuvent entraîner des variations dans le contenu importé par rapport à la source d’origine.
{% endhint %}
### Limitations
GitBook impose actuellement les limites suivantes pour le contenu importé :
* Le nombre maximal de pages pouvant être téléversées lors d’une seule importation est **20**.
* Le nombre maximal de fichiers (images, etc.) pouvant être téléversés lors d’une seule importation est **20**.
***
## Importer depuis un dépôt GitHub ou GitLab à l’aide de Git Sync
Lorsque vous importez de grands volumes de contenu dans GitBook, nous vous recommandons d’utiliser [Synchronisation Git](/url/gitbook.com/docs/documentation/fr/getting-started/git-sync.md). Bien que notre outil de migration intégré puisse gérer la plupart des importations, Git Sync est mieux adapté pour gérer efficacement des migrations plus volumineuses.
{% hint style="info" %}
Vous trouverez ci-dessous les étapes essentielles pour importer votre contenu. Pour des étapes plus détaillées et une démonstration vidéo, consultez notre guide dédié à [l’importation de contenu dans GitBook à l’aide de Git Sync](/url/gitbook.com/docs/guides/editing-and-publishing-documentation/import-or-migrate-your-content-to-gitbook-with-git-sync.md).
{% endhint %}
{% stepper %}
{% step %}
**Convertissez votre contenu en Markdown**
GitBook est basé sur Markdown, donc l’importation de contenu au format Markdown donnera les meilleurs résultats. Si vos outils actuels prennent en charge l’exportation en Markdown, nous vous recommandons d’utiliser ce format pour un processus d’importation plus fluide.
Si votre contenu n’est pas déjà dans des fichiers Markdown, nous vous recommandons d’utiliser un script (comme [Markitdown](https://github.com/microsoft/markitdown)) ou un outil en ligne pour convertir votre contenu.
{% endstep %}
{% step %}
**Organisez votre contenu dans GitHub ou GitLab**
Lors de la configuration de votre site GitBook, il est essentiel d’organiser efficacement votre contenu dans votre dépôt GitHub ou GitLab. Comme Git Sync s’effectue au niveau de l’espace, planifiez soigneusement la manière de regrouper votre contenu. Créez plusieurs dépôts ou dossiers, en veillant à ce que les fichiers Markdown nécessaires se trouvent aux bons emplacements.
{% endstep %}
{% step %}
**Configurez les espaces et Git Sync**
Pour organiser votre contenu, créez un ou plusieurs espaces dans GitBook selon vos besoins. Installez les intégrations [Synchronisation GitHub](https://www.gitbook.com/integrations/github-sync) ou [GitLab Sync](https://www.gitbook.com/integrations/gitlab-sync) dans votre organisation et configurez-les pour ces espaces. Vous devrez synchroniser votre espace avec le dossier ou le dépôt que vous avez configuré à l’étape précédente.
{% endstep %}
{% step %}
**Exécutez Git Sync dans la direction GitHub → GitBook**
Lors du processus de configuration, assurez-vous de sélectionner la direction GitHub → GitBook. Cela entraînera l’importation du contenu de votre dossier ou dépôt depuis GitHub ou GitLab vers GitBook.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/getting-started/import.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.