> 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/creer/mise-en-forme-de-votre-contenu/contenu-en-ligne.md).

# Contenu en ligne

<figure><img src="https://601792523-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQdlZrbfmgS8KBIQC0kYO%2Fuploads%2Fgit-blob-ff408ea9fda9c18aa7bcaf84c90bfe14040c9c87%2F26_01_22_inline%20palette%402x.png?alt=media" alt="A GitBook screenshot showing inline content options"><figcaption><p>Ajoutez des éléments en ligne à votre contenu.</p></figcaption></figure>

La palette en ligne vous permet d’ajouter rapidement du contenu dans un bloc de texte, sans quitter le clavier.

Tapez `/` dans n’importe quel bloc de texte pour ouvrir la palette. Le caractère `/` sera remplacé par l’élément que vous insérez.

{% hint style="info" %}
Cette page vise des **collaborateurs** qui peuvent éditer un ou plusieurs espaces. Certains réglages, comme le thème ou la publication, sont gérés par les responsables de l’espace ou l’équipe SIC.
{% endhint %}

### Annotations

Avec les annotations, vous pouvez ajouter un contexte supplémentaire à vos mots sans briser le fil de la pensée du lecteur. Vous pouvez les utiliser pour expliquer le sens d'un mot, insérer des informations supplémentaires, et plus encore. Les lecteurs peuvent survoler le texte annoté pour afficher l'annotation au-dessus du texte.

#### Créer une annotation

Pour créer une annotation, sélectionnez le texte à annoter puis cliquez sur l’option **Annoter** dans le menu contextuel. Une fois l’annotation rédigée, cliquez ailleurs pour continuer à écrire dans le bloc de texte.

#### Représentation Markdown

Vous pouvez écrire du contenu en [notes de bas de page Markdown](https://www.markdownguide.org/extended-syntax/#footnotes) pour les ajouter comme annotations dans GitBook. Les indicateurs de note de bas de page doivent apparaître immédiatement après le mot que vous souhaitez annoter ; ils ne doivent pas apparaître après des signes de ponctuation ou d'autres symboles.

```markdown
Voici une simple note de bas de page[^1], et en voici une plus longue[^bignote].

[^1]: Ceci est la première note de bas de page.

[^bignote]: En voici une avec plusieurs paragraphes et du code.

    Indentez les paragraphes pour les inclure dans la note de bas de page.

    `{ mon code }`

    Ajoutez autant de paragraphes que vous le souhaitez.
```

### Images

Les images en ligne s'affichent à côté de votre texte sur la page.

Par défaut, les images sont définies à leur taille d'origine avec une largeur maximale de 300 px. Vous pouvez changer la taille en cliquant sur l'image pour ouvrir la palette de formatage, puis en choisissant l'une des trois options :

1. **Taille en ligne :** L'image est redimensionnée proportionnellement à la police — idéal pour les icônes et les badges.
2. **Taille originale :** L'image restera en ligne à sa taille d'origine, avec une largeur maximale de 300 pixels.
3. **Convertir en bloc :** Cela transforme une image en ligne en un [bloc d'image](https://gitbook.com/docs/documentation/fr/creating-content/blocks/insert-images), qui est aussi large que votre contenu.

{% hint style="info" %}
[Blocs d'image](https://gitbook.com/docs/documentation/fr/creating-content/blocks/insert-images) offrent plus d'options, y compris plus de tailles et la possibilité d'ajouter une légende — mais n'apparaîtront pas en ligne avec votre texte.
{% endhint %}

#### Représentation en Markdown

{% code overflow="wrap" %}

```markdown
Voici une image en ligne : <img src=".gitbook/assets/GitBook - Dark.jpg" alt="Version sombre du logo GitBook" data-size="line">
```

{% endcode %}

### Émojis

Vous pouvez ajouter des émojis en appuyant sur `/` pour ouvrir la palette en ligne. Alternativement, tapez `:` et une liste d'émojis apparaîtra directement en ligne — vous pouvez commencer à taper le nom d'un émoji pour affiner la sélection.

#### Représentation en Markdown

{% code overflow="wrap" %}

```markdown
:house:
:car:
:dog:
```

{% endcode %}

### Liens

Vous pouvez insérer trois types de liens différents :

* [Liens relatifs](#liens-relatifs)
* [Liens absolus](#liens-absolus)
* [Liens `mailto`](#liens-mailto)

#### Liens relatifs

Les liens relatifs sont des liens créés en reliant à [pages](https://gitbook.com/docs/documentation/fr/creating-content/content-structure/page) qui existent déjà dans votre espace. L'avantage d'utiliser des liens relatifs est que si l'URL, le nom ou l'emplacement de la page change, sa référence restera à jour — vous aurez donc moins de liens brisés.

Voici comment insérer un lien relatif :

1. Cliquez quelque part dans votre paragraphe où vous souhaitez insérer le lien, ou sélectionnez du texte.
2. Appuyez sur `/` pour ouvrir la palette en ligne et choisissez **Lien**, cliquez sur le bouton **Lien** dans le menu contextuel, ou appuyez sur **⌘ + K**.
3. Commencez à taper le titre de la page vers laquelle vous voulez créer le lien.
4. Sélectionnez la page dans les résultats de recherche déroulants.
5. Appuyez sur `Entrée`.

#### Liens absolus

Les liens absolus sont des liens externes que vous pouvez copier-coller dans votre contenu. Ils sont utiles lorsque vous souhaitez faire un lien vers quelque chose en dehors de votre documentation.

Pour insérer un lien absolu :

1. Cliquez quelque part dans votre paragraphe où vous souhaitez insérer le lien, ou sélectionnez du texte.
2. Appuyez sur `/` pour ouvrir la palette en ligne et choisissez **Lien**, cliquez sur le bouton **Lien** dans le menu contextuel, ou appuyez sur **⌘ + K**.
3. Collez l'URL vers laquelle vous souhaitez créer le lien.
4. Appuyez sur `Entrée`.

{% hint style="info" %}
**Pourquoi les liens externes ne s'ouvrent-ils pas dans un nouvel onglet ?**

Lorsque vous ajoutez un lien vers un site externe dans vos docs, il s'ouvrira dans le même onglet.

GitBook suit ce [comportement recommandé par le W3C](https://www.w3.org/TR/WCAG20-TECHS/G200.html) pour prendre en charge [l'accessibilité](https://it.wisc.edu/learn/make-it-accessible/websites-and-web-applications/when-to-open-links-in-a-new-tab/) et garantir une expérience cohérente et inclusive pour vos lecteurs.
{% endhint %}

#### Liens `mailto`

Les liens `mailto` sont utiles lorsque vous voulez que vos visiteurs sélectionnent un lien qui ouvre leur client de messagerie par défaut. Le champ `Pour` est prérempli avec l’adresse de courriel du lien.

Voici comment insérer un lien `mailto` vers une adresse de courriel :

1. Cliquez quelque part dans votre paragraphe où vous souhaitez insérer le lien, ou sélectionnez du texte.
2. Appuyez sur `/` pour ouvrir la palette en ligne et choisissez **Lien**, cliquez sur le bouton **Lien** dans le menu contextuel, ou appuyez sur **⌘ + K**.
3. Collez ou tapez `mailto:something@address.com`, en remplaçant `something@address.com` par l’adresse de courriel souhaitée.
4. Appuyez sur `Entrée`.

#### Représentation en Markdown

```markdown
[Ceci est un lien relatif vers une autre page de cet espace](/spaces/ABmOVeQNs06LKvGKdg46/pages/52d099dc39eb5fb8e4e03063cc034366174787e2)
[Ceci est un lien absolu](https://www.gitbook.com/blog)
[Ceci est un lien](mailto:support@gitbook.com) vers notre adresse e-mail de support
```

### Mathématiques & TeX

En utilisant cette option, vous pouvez créer une formule mathématique en ligne dans votre contenu, comme ceci : $$f(x) = x \cdot e^{2 \pi i \xi x}$$.

Nous utilisons la bibliothèque [KaTeX](https://katex.org/docs/supported.html) pour rendre les formules.

{% hint style="info" %}
Vous pouvez aussi insérer [une formule mathématique au niveau bloc](https://gitbook.com/docs/documentation/fr/creating-content/blocks/math-and-tex) en ouvrant la palette de commandes dans un bloc vide et en choisissant la seconde option Math & TeX.
{% endhint %}

#### Représentation en Markdown

```markdown

# Bloc Math et TeX

$$f(x) = x \cdot e^{2 \pi i \xi x}$$
```

### Boutons

Les boutons sont un excellent moyen de décrire des appels à l'action. Vous pouvez les utiliser pour envoyer les utilisateurs vers d'autres pages dans GitBook, ou vers des URL externes.

Les boutons ont des styles primaire et secondaire. Voici quelques exemples :

<a href="/applications/gitbook/commencer/demarrage-rapide.md" class="button primary">Ouvrir le démarrage rapide</a> <a href="#annotations" class="button secondary">Aller aux annotations</a>

#### Représentation en Markdown

```markdown
<a href="/spaces/ABmOVeQNs06LKvGKdg46/pages/52d099dc39eb5fb8e4e03063cc034366174787e2" class="button primary">Démarrage rapide</a>
```

### Icônes

Les icônes vous permettent d’ajouter des indications visuelles supplémentaires à votre site. Vous pouvez les ajouter en ligne dans des paragraphes, à l’intérieur d’une carte, ou partout où vous avez besoin d’un repère visuel.

Elles utilisent le style visuel défini dans les paramètres de personnalisation du site. Selon votre rôle, ces paramètres peuvent être en lecture seule.

<i class="fa-facebook">:facebook:</i> <i class="fa-github">:github:</i> <i class="fa-x-twitter">:x-twitter:</i> <i class="fa-instagram">:instagram:</i>

Visitez [Font Awesome](https://fontawesome.com/) pour explorer les différentes icônes disponibles.

#### Représentation en Markdown

```markdown
<i class="fa-github">:github:</i>
```

### Expressions

Les expressions vous permettent d'afficher dynamiquement du contenu défini dans une [variable](https://gitbook.com/docs/documentation/fr/creating-content/variables-and-expressions). Les expressions peuvent être insérées depuis le `/` menu. Une fois insérée, un double-clic sur l'expression fera apparaître l'éditeur d'expression, vous permettant de référencer et de [formater conditionnellement](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Conditional_operator) votre variable.


---

# 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/creer/mise-en-forme-de-votre-contenu/contenu-en-ligne.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.