> For the complete documentation index, see [llms.txt](https://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.com/docs/documentation/fr/getting-started/import.md).

# Migrer vers GitBook

Comment importer du contenu existant dans GitBook depuis Confluence, Notion, Git et plus encore

Vous pouvez migrer et unifier la documentation existante dans GitBook à l’aide de l’outil d’import.

Vous pouvez importer une ou plusieurs pages à l’aide de notre outil d’importation intégré, ou [un dépôt Git entier avec Git Sync](#import-using-git-sync).

## Utilisation du panneau d’import

Le panneau d’import facilite la migration de votre contenu dans 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’import. Cela 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 les blocs GitBook plus efficacement. Vous pouvez désactiver cette option depuis le menu.

### Formats d’import 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 importer un fichier ZIP contenant des fichiers HTML ou Markdown, ou utiliser l’option d’importation de **Online docs** .

{% hint style="info" %}
GitBook est basé sur Markdown, donc importer du contenu au format Markdown donnera les meilleurs résultats. Si vos outils actuels prennent en charge l’export au format Markdown, nous vous recommandons d’utiliser ce format pour un processus d’import plus fluide.
{% endhint %}

### Le panneau d’import

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-fee6329e5d4ed9522490f472129a8a1a1efceea1%2F25_12_10_import%402x.png?alt=media" alt="A GitBook screenshot showing the import panel"><figcaption><p>Le panneau d’import dans GitBook.</p></figcaption></figure>

Lorsque vous créez une nouvelle section, vous pouvez importer du contenu dans la fenêtre modale qui s’affiche. Si vous créez une section vide, vous pouvez également importer du contenu depuis la section **Démarrage rapide** en bas de la nouvelle page vide, après avoir cliqué sur **Modifier**.

Vous pouvez également importer une page ou une sous-page à tout moment en sélectionnant **Ajouter** > **Importer des pages** en bas de la [table des matières](https://gitbook.com/docs/documentation/fr/reference/gitbook-ui.md#table-of-contents), ou en ouvrant le **menu Actions** <picture><source srcset="broken://files/YjlF3Z9KMYv9aQiFzZKD" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2F25_01_10_actions_icon_light.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> d’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 des différences dans les fonctionnalités du produit et les formats de documents 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 importées en une seule fois est de **20**.
* Le nombre maximal de fichiers (images, etc.) pouvant être importés en une seule fois est **20**.

GitBook ne peut pas augmenter ces limites d’importation. Pour importer davantage de contenu à la fois, utilisez [Git Sync](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync.md), qui prend en charge jusqu’à 5 000 pages Markdown.

***

## Importer depuis un dépôt GitHub ou GitLab à l’aide de Git Sync <a href="#import-using-git-sync" id="import-using-git-sync"></a>

Pour importer de grandes quantités de contenu dans GitBook, nous vous recommandons d’utiliser [Git Sync](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync.md). Notre outil de migration intégré peut gérer la plupart des importations, mais Git Sync est mieux adapté aux migrations de grande envergure et les traite plus efficacement.

{% hint style="info" %}
Vous trouverez ci-dessous les étapes essentielles pour importer votre contenu. Pour obtenir des instructions plus détaillées et voir une démonstration vidéo, consultez notre guide dédié à [l’importation de contenu dans GitBook avec Git Sync](https://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 importer du contenu au format Markdown donnera les meilleurs résultats. Si vos outils actuels prennent en charge l’export au format Markdown, nous vous recommandons d’utiliser ce format pour un processus d’import plus fluide.

Si votre contenu n’est pas déjà au format Markdown, nous vous recommandons d’utiliser un script (comme [Markitdown](https://github.com/microsoft/markitdown)) ou un outil en ligne pour le convertir.
{% endstep %}

{% step %}
**Organisez votre contenu dans GitHub ou GitLab**

Lors de la configuration de votre site GitBook, il est crucial d’organiser efficacement votre contenu dans votre dépôt GitHub ou GitLab. Comme Git Sync s’effectue au niveau de la section, 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 emplacements corrects.
{% endstep %}

{% step %}
**Mettez en place des sections et configurez Git Sync**

Pour organiser votre contenu, créez une ou plusieurs sections dans GitBook selon vos besoins. Installez l’intégration [GitHub Sync](https://www.gitbook.com/integrations/github-sync) ou [GitLab Sync](https://www.gitbook.com/integrations/gitlab-sync) dans votre organisation et configurez-la pour ces sections. Vous devrez synchroniser votre section avec le dossier ou le dépôt configuré à l’étape précédente.
{% endstep %}

{% step %}
**Exécutez Git Sync dans le sens GitHub → GitBook**

Lors du processus de configuration, assurez-vous de sélectionner la direction GitHub → GitBook. Le contenu de votre dossier ou dépôt sera alors récupéré depuis GitHub ou GitLab vers GitBook.
{% endstep %}
{% endstepper %}

## Exportez votre contenu

Vous pouvez exporter votre contenu GitBook de deux façons :

* **Au format Markdown**, en la synchronisant avec un dépôt Git. L’application ne permet pas d’exporter directement au format Markdown : synchronisez la section à exporter avec un dépôt GitHub ou GitLab vide à l’aide de [Git Sync](https://gitbook.com/docs/documentation/fr/docs-as-code/git-sync.md), et le dépôt constituera votre export Markdown. Certains blocs n’ont pas de représentation Markdown et apparaissent au format HTML dans l’export.
* **Au format PDF**, depuis le menu Actions de la page ou de la section. Voir [Exportation au format PDF](https://gitbook.com/docs/documentation/fr/publish/pdf-export.md). L’exportation de sections très volumineuses peut être soumise à des limites.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/fr/getting-started/import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
