> For the complete documentation index, see [llms.txt](https://smedai.aivd.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smedai.aivd.ch/applications/gitbook/commencer/migrer-vers-gitbook.md).

# Migrer vers GitBook

Vous pouvez migrer et unifier une documentation existante dans GitBook avec l’outil d’importation.

L’import sert surtout à **créer une base**. Ensuite, relisez et ajustez la mise en forme.

### Ce que l’import gère (résumé)

* **Fichiers** (recommandé) : importer une page ou un lot de pages depuis votre machine.
* **Sources externes** : importer depuis une URL ou depuis des outils tiers (voir plus bas).

Par défaut, l’IA peut **nettoyer et adapter** la mise en forme pendant l’import. Vous pouvez désactiver l’option.

{% hint style="warning" %}
Selon la source, le rendu peut différer. Prévoyez une relecture.
{% endhint %}

## Importer de la documentation via fichiers

Le panneau d’importation est le moyen le plus simple pour migrer du contenu existant depuis des fichiers.

### Formats pris en charge

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

Pour importer **plusieurs pages**, téléversez un fichier **ZIP** contenant des fichiers Markdown ou HTML.

{% hint style="info" %}
Markdown donne généralement les meilleurs résultats.
{% endhint %}

### Ouvrir le panneau d’importation

<figure><img src="https://601792523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdlZrbfmgS8KBIQC0kYO%2Fuploads%2Fgit-blob-fee6329e5d4ed9522490f472129a8a1a1efceea1%2FImport%402x%20(1).png?alt=media" alt="Capture d’écran du panneau d’importation"><figcaption><p>Le panneau d’importation.</p></figcaption></figure>

Vous pouvez importer à plusieurs endroits :

* À la création d’un nouvel espace, via la fenêtre modale.
* Dans un espace vide, via la section **Démarrage rapide** en bas de page (après avoir cliqué **Modifier**).
* Depuis une page existante, via :
  * **Ajouter** → **Importer des pages** (en bas de la table des matières)
  * ou le **menu Actions** ![Icône du menu Actions](https://601792523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdlZrbfmgS8KBIQC0kYO%2Fuploads%2Fgit-blob-aabbca522107ef561981bdfe5af94605b31e0920%2Factions.svg?alt=media) → **Importer des sous-pages**

### Importer un fichier ou un ZIP

{% stepper %}
{% step %}

### Choisir la source « Fichiers »

Sélectionnez l’option d’import depuis des fichiers.
{% endstep %}

{% step %}

### Sélectionner le fichier

Choisissez un fichier (`.md`, `.html`, `.docx`) ou un **ZIP** (pour plusieurs pages).
{% endstep %}

{% step %}

### Vérifier le résultat

Contrôlez les titres, la structure, les images et les liens. Corrigez ce qui doit l’être avant publication.
{% endstep %}
{% endstepper %}

### Limites actuelles

* Max **20 pages** par import.
* Max **20 fichiers** (images, assets, etc.) par import.

## Autres sources (explication synthétique)

Vous pouvez aussi importer depuis :

* un site de documentation en ligne (via une URL)
* Confluence
* Notion
* Quip
* Dropbox Paper
* Google Docs

Le principe reste le même : choisissez la source dans le panneau d’import, puis suivez l’assistant.


---

# 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://smedai.aivd.ch/applications/gitbook/commencer/migrer-vers-gitbook.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.