Le bloc **Commentaire** ne se limite plus à une ligne de texte brut : vous pouvez y mettre des titres, du gras, du surlignage, des listes, des cases à cocher et des liens, comme dans un traitement de texte. Le graphe affiche ensuite cette mise en forme directement dans le bloc. C'est idéal pour un plan de chapitre, une liste de choses à faire ou une note détaillée à côté des blocs qu'elle explique.

![Un bloc Commentaire sur le graphe avec le titre « Acte I », une phrase avec un mot en gras, deux puces et une tâche cochée, barrée](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaTRLIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--71e4ba16d38ab098c0b97664855fe33eb37452ae/blocs--commentaire-ouvert-texte-riche.fr.png)
*un bloc Commentaire en texte riche : un titre, du gras, une liste à puces et une tâche cochée*

## Ouvrir l'éditeur du commentaire

1. Double-cliquez sur le bloc **Commentaire**. La fenêtre **Édition du commentaire** s'ouvre (voir [La Fenêtre d'Édition d'un Bloc](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-la-fenetre-d-edition-d-un-bloc-c1182f)).
2. Écrivez dans la zone **Commentaire**. La barre d'outils au-dessus du texte applique la mise en forme.
3. Réglez au besoin la **Taille de la police**, la **Couleur du fond** et la **Police**, sous la zone de texte.

Il n'y a pas de bouton pour enregistrer : le texte est enregistré dès que vous cliquez en dehors de la zone de texte ou que vous fermez la fenêtre. La taille, la couleur et la police sont enregistrées dès que vous les changez.

![La fenêtre « Édition du commentaire » : la barre d'outils, la zone Commentaire, puis Taille de la police, Couleur du fond et Police](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBakFLIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--9afe91a4c8b4dfb036cfdb99e070a4971451e936/blocs--commentaire-edition-texte-riche.fr.png)
*la fenêtre « Édition du commentaire » et sa barre d'outils*

## Les boutons de la barre d'outils

| Bouton | Effet |
|---|---|
| **Gras**, **Italique**, **Souligné**, **Barré** | met en forme le texte sélectionné |
| **Surligner** | colore le fond du texte sélectionné, avec une couleur à choisir ; **Retirer le surlignage** l'enlève |
| **Titre 1**, **Titre 2**, **Titre 3** | transforme le paragraphe en titre (le Titre 1 est le plus grand) |
| **Citation** | met le paragraphe en retrait, comme une citation |
| **Liste à puces**, **Liste numérotée** | transforme le paragraphe en élément de liste |
| **Liste de tâches** | ajoute une case à cocher devant le paragraphe |
| **Aligner à gauche**, **Centrer**, **Aligner à droite** | aligne le paragraphe |
| **Insérer un lien** | ajoute un lien sur le texte sélectionné |
| **Insérer un emoji** | ouvre une grille d'emoji, avec une recherche et des catégories |
| **Copier le contenu** | copie tout le texte du commentaire |
| **Plein écran** | ouvre le texte en grand (voir plus bas) |

Raccourcis clavier : Ctrl + B (gras), Ctrl + I (italique), Ctrl + U (souligné) et Ctrl + Maj + X (barré). Sur Mac, utilisez Cmd à la place de Ctrl.

### Les cases à cocher

Avec **Liste de tâches**, chaque ligne reçoit une case. Cliquez sur la case dans la fenêtre d'édition pour la cocher : le texte de la ligne est alors barré et grisé, dans l'éditeur comme sur le graphe. Pratique pour suivre ce qui reste à faire dans une scène.

### Les liens

Cliquez sur **Insérer un lien**, collez l'adresse dans le champ **Saisissez ou collez un lien**, puis cliquez sur **Appliquer**. Sont acceptés : une adresse web (comme exemple.fr), une adresse e-mail ou un numéro de téléphone (tel:+33...). Une autre adresse affiche « Ce lien ne peut pas être utilisé ».

Pour modifier un lien, double-cliquez dessus dans l'éditeur : vous pouvez alors **Modifier** ou **Supprimer** le lien. Coller seule dans le texte une adresse web complète, commençant par http:// ou https://, en fait directement un lien.

Sur le graphe, un lien s'affiche souligné. Ctrl + clic (Cmd + clic sur Mac) sur le lien l'ouvre dans un nouvel onglet, sans sélectionner ni déplacer le bloc.

## Coller un texte écrit en Markdown

Si vous collez un texte écrit en Markdown (par exemple depuis un autre outil ou un assistant IA), il est converti en mise en forme. Sont reconnus notamment :

| Vous collez | Vous obtenez |
|---|---|
| `# `, `## `, `### ` en début de ligne | un titre 1, 2 ou 3 |
| `**texte**` | du gras |
| `~~texte~~` | du barré |
| `- ` ou `* ` en début de ligne | une liste à puces |
| `1. ` en début de ligne | une liste numérotée |
| `> ` en début de ligne | une citation |
| `- [ ] ` ou `- [x] ` | une case à cocher, vide ou cochée |
| `[texte](https://…)` | un lien |

Dans l'autre sens, une partie du texte sélectionnée puis copiée part dans le presse-papiers en Markdown : l'essentiel de la mise en forme (titres, gras, listes, liens…) est gardé si vous la collez dans un autre commentaire ou un outil qui lit le Markdown.

## Taille, police et couleur

- **Taille de la police** : un nombre, en pixels (16 par défaut). Les titres s'affichent plus grands que cette taille, proportionnellement. Les anciens commentaires réglés sur Petite, Moyenne ou Grande s'affichent en 16, 24 et 36 pixels.
- **Couleur du fond** : la couleur du bloc sur le graphe.
- **Police** : la police du texte, dans l'éditeur et sur le graphe. Sans choix, c'est la police générale de l'application.

## Redimensionner le bloc sur le graphe

Par défaut, le bloc prend la taille de son texte : chaque paragraphe tient sur une seule ligne et le bloc s'agrandit avec lui.

Pour lui donner une taille fixe, approchez la souris du coin inférieur droit du bloc : le curseur devient une double flèche en diagonale. Tirez alors ce coin. Le texte revient à la ligne pour tenir dans la largeur choisie ; s'il est trop long pour la hauteur, les dernières lignes sont masquées et la dernière visible se termine par « … ». Le texte complet reste dans la fenêtre d'édition.

## Écrire en plein écran

Pour une note longue, cliquez sur **Plein écran**, à droite de la barre d'outils. Le texte s'ouvre sur toute la fenêtre, sous le titre **Édition en plein écran**, avec la même barre d'outils.

![L'éditeur en plein écran : le titre « Édition en plein écran », la barre d'outils et un texte avec un titre, un paragraphe et une liste](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBakVLIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5569ae638738d589036d0552a1e4906c31628f4b/graph-editeurs-bloc--commentaire-plein-ecran.fr.png)
*l'édition en plein écran ; en haut à droite, Pleine largeur, Copier le contenu et Quitter le plein écran*

En haut à droite :

| Bouton | Effet |
|---|---|
| **Pleine largeur** | étale le texte sur toute la largeur de l'écran ; le même bouton, devenu **Largeur de lecture**, revient à une colonne centrée plus confortable à lire |
| **Copier le contenu** | copie tout le texte |
| **Quitter le plein écran (Échap)** | revient à la fenêtre d'édition ; la touche Échap fait de même |

## Relier un commentaire à un bloc avec une flèche

Un commentaire peut pointer vers le bloc qu'il explique :

1. Faites un clic droit sur le bloc **Commentaire** (seul, sans autre élément sélectionné).
2. Choisissez **Relier à…**.
3. Cliquez sur le bloc ou la forme à relier. Échap pour annuler.

Une flèche relie alors le commentaire à ce bloc. Les flèches sont détaillées dans [Annoter le graphe : flèches, formes et post-it](https://documentation.celestory.io/hc/celestorydoc/articles/1795338885-annoter-le-graphe-fleches-formes-et-post_it).

![Le menu du clic droit sur un bloc Commentaire, avec « Relier à… » en deuxième position](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBaklLIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ee39148b3c89721fef051db7d13d5404e262f3c8/graph-context-menus--commentaire-menu-clic-droit.fr.png)
*le clic droit sur un bloc Commentaire, avec « Relier à… »*

## 💡 Exemple d'utilisation

Le plan de l'acte I, posé à côté des blocs de la scène :

1. Ajoutez un bloc **Commentaire** près du début de la scène et double-cliquez dessus.
2. Tapez « Acte I », puis cliquez sur **Titre 1**. Appuyez sur Entrée : la nouvelle ligne reste un titre, cliquez donc de nouveau sur **Titre 1** pour revenir à un texte normal.
3. À la ligne suivante, écrivez « Le héros arrive au village » et mettez « arrive » en **Gras**.
4. Écrivez « parler au forgeron » et « trouver la clé » sur deux lignes, sélectionnez ces deux lignes, puis cliquez sur **Liste à puces**.
5. Ajoutez « écrire le dialogue » et cliquez sur **Liste de tâches**. Une fois le dialogue écrit, cochez la case : la ligne est barrée sur le graphe.
6. Faites un clic droit sur le commentaire, choisissez **Relier à…** et cliquez sur le premier bloc de la scène.

## À savoir

- Le bloc Commentaire n'est jamais exécuté : il n'a ni entrée ni sortie et le joueur ne le voit pas. Sa mise en forme ne sert qu'à vous et à votre équipe.
- La recherche d'emoji se fait en anglais (« Rechercher un emoji (en anglais) ») : tapez par exemple « heart » ou « star ».
- Taper `# ` ou `- ` dans un commentaire ne crée pas de titre ni de liste : utilisez les boutons, ou collez le texte déjà écrit en Markdown.
- Un ancien commentaire en texte brut s'ouvre tel quel ; il n'est modifié que si vous changez son texte.

## 🔗 Voir aussi

- [⬜ Commentaire](https://documentation.celestory.io/hc/celestorydoc/articles/fr-blocs-commentaire-511219)
- [Annoter le graphe : flèches, formes et post-it](https://documentation.celestory.io/hc/celestorydoc/articles/1795338885-annoter-le-graphe-fleches-formes-et-post_it)
- [La Fenêtre d'Édition d'un Bloc](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-la-fenetre-d-edition-d-un-bloc-c1182f)
- [Mettre en forme un texte avec Markdown](https://documentation.celestory.io/hc/celestorydoc/articles/1795347786-mettre-en-forme-un-texte-avec-markdown)
- [Menu des Blocs (clic droit)](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-menu-des-blocs-clic-droit-ca9e28)
