# Importation de contenu

Vous pouvez migrer et unifier la documentation existante dans GitBook en utilisant l’outil d’importation.

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

## Utilisation du panneau d’importation

### Formats d’importation pris en charge

GitBook prend en charge l’importation de sites web ou de fichiers dans les formats suivants :

* Markdown (`.md` ou `.markdown`)
* HTML (`.html`)
* Microsoft Word (`.docx`)

Nous prenons également en charge l’importation depuis :

* Confluence
* Notion
* GitHub Wiki
* Quip
* Dropbox Paper
* Google Docs

Si vous souhaitez **importer plusieurs pages**, vous pouvez télécharger un fichier ZIP contenant des fichiers HTML ou Markdown.

{% 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 permettent l’exportation en Markdown, nous vous recommandons d’utiliser ce format pour un processus d’importation plus fluide.
{% endhint %}

### Le panneau d’importation

<figure><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2FQPGDN9Aja68uaLDdZt9M%2Fgetting-started-import-panel.svg?alt=media&#x26;token=bf7114a5-c02c-4dfd-acc5-cf527d68309d" alt="A GitBook screenshot showing the import panel"><figcaption><p>Le panneau d’importation dans GitBook.</p></figcaption></figure>

Lorsque vous créez un nouvel espace, vous aurez la possibilité d’importer du contenu depuis le bas de la première page vide.

Sinon, vous pouvez toujours importer une page ou une sous-page en sélectionnant **Nouvelle page** > **Importer de nouvelles pages** dans le [sommaire](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/ressources/gitbook-ui#table-of-contents), ou en ouvrant le menu Actions <picture><source srcset="broken-reference" media="(prefers-color-scheme: dark)"><img src="https://3903131528-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2F89MTSo5XRpPMVr1T0rxS%2Factions.svg?alt=media&#x26;token=2b5d001e-560a-4f29-8d22-de8163725ca1" alt="The Actions menu icon in GitBook"></picture> 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 à partir de diverses sources, mais des différences dans les fonctionnalités des produits et les formats de documents peuvent entraîner des variations dans le contenu importé par rapport à la source d’origine.
{% endhint %}

### Limitations

GitBook a actuellement les limites suivantes pour le contenu importé :

* Le nombre maximum de pages pouvant être téléchargées en une seule importation est de **20**.
* Le nombre maximum de fichiers (images, etc.) pouvant être téléchargés en une seule importation est de **20**.

***

## Importer en utilisant Git Sync

Pour importer de grands volumes de contenu dans GitBook, nous recommandons d’utiliser [Git Sync](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/fr/commencer/git-sync). Contrairement à notre outil d’importation intégré, Git Sync est mieux adapté pour gérer efficacement de plus grandes migrations.

{% 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 avec Git Sync](https://app.gitbook.com/s/LBGJKQic7BQYBXmVSjy0/editing-and-publishing-documentation/import-or-migrate-your-content-to-gitbook-with-git-sync).
{% endhint %}

Voici comment faire :

{% 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 permettent 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à sous forme de 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 crucial d’organiser efficacement votre contenu dans votre dépôt GitHub ou GitLab. Puisque Git Sync s’effectue au niveau de l’espace, planifiez soigneusement la façon de regrouper votre contenu. Créez plusieurs dépôts ou dossiers, en vous assurant que les fichiers Markdown nécessaires se trouvent aux bons endroits.
{% 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 [GitHub Sync](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 le sens GitHub → GitBook

Lors de la configuration, assurez-vous de sélectionner la direction GitHub → GitBook. Cela permettra de rapatrier le contenu de votre dossier ou dépôt depuis GitHub ou GitLab vers GitBook.
{% endstep %}
{% endstepper %}
