Les blocs de légende : info, succès, avertissement, danger

Nextcloud Text propose quatre types de bandeaux colorés pour mettre en valeur un message selon sa nature. On les appelle des légendes dans l'interface, et on y accède de deux façons : via le menu Blocs dans la barre d'outils, ou en tapant directement la syntaxe.

:::info
Ceci est une information générale.
:::

:::success
L'opération s'est bien déroulée.
:::

:::warn
Attention, vérifiez bien ce point avant de continuer.
:::

:::error
Erreur critique : cette action est irréversible.
:::

Ce qui produit quatre bandeaux distincts, chacun avec son icône et sa couleur :

Le contenu à l'intérieur du bloc supporte la mise en forme Markdown habituelle : gras, italique, listes, liens… Tout fonctionne normalement entre les :::.

Un point important à retenir

Cette syntaxe ::: est propre à Nextcloud. Elle ne fait pas partie du Markdown standard et ne sera pas interprétée dans un autre éditeur. Si vous ouvrez un fichier .md contenant des blocs ::: dans un autre outil, vous verrez le texte brut s'afficher tel quel, sans mise en forme. C'est à garder en tête si vous partagez vos fichiers en dehors de Nextcloud.

Les blocs dépliants : cacher du contenu jusqu'au clic

L'autre fonctionnalité très pratique : les blocs dépliants, aussi appelés accordéons. Le principe est simple, un titre cliquable, et un contenu qui se révèle quand on clique dessus. Idéal pour les FAQ, les procédures étape par étape, ou pour ne pas surcharger visuellement un document long.

<details>
<summary>Mon titre visible</summary>
Le contenu caché, révélé au clic.
</details>

Ce qui donne un bloc fermé avec juste le titre visible, et qui s'ouvre au clic pour révéler le contenu.

Ce qui est particulièrement intéressant dans Nextcloud : le Markdown est interprété à l'intérieur du bloc. Vous pouvez donc y mettre du gras, des listes, des liens, des cases à cocher…

<details>
<summary>Procédure d'installation</summary>

Avant de commencer, vérifiez les **prérequis** suivants :

- Avoir un accès administrateur
- Disposer d'au moins 2 Go d'espace disque
- [Consulter la documentation](https://example.org)

</details>

Des usages concrets

Une FAQ dans un document de réunion, les questions récurrentes sont accessibles sans alourdir la lecture principale.

Une procédure avec des étapes optionnelles, on cache les détails techniques pour les utilisateurs avancés, le document reste lisible pour tout le monde.

Un document de formation, on peut cacher la réponse à un exercice sous un bloc dépliant, le stagiaire réfléchit d'abord avant de cliquer.

Un compte-rendu avec des annexes, les informations complémentaires sont disponibles sans interrompre la lecture du résumé.

Ce qu'il faut savoir sur la portabilité

Contrairement aux blocs :::, la syntaxe <details> est du HTML standard, elle est reconnue dans la grande majorité des outils qui interprètent du Markdown, y compris GitHub, GitLab, et de nombreux CMS. C'est donc une option plus portable si vous partagez vos fichiers en dehors de Nextcloud.

En revanche, elle implique d'écrire quelques balises HTML, ce qui peut sembler moins naturel que la syntaxe Markdown habituelle. En pratique, une fois le modèle en tête, ça va très vite.

En résumé

Ces deux fonctionnalités transforment un simple fichier .md en document bien structuré et agréable à liren sans avoir besoin d'un outil de mise en page complexe. Les bandeaux colorés guident l'attention, les blocs dépliants allègent la lecture. Utilisés avec parcimonie, ils rendent vos documents Nextcloud nettement plus professionnels.

Cet article fait partie d'une série sur le Markdown et son utilisation dans Nextcloud :

- Le Markdown : un format simple et puissant, même sans être informaticien

- Les tableaux en Markdown : tout ce qu'il faut savoir

Ézéo est une coopérative bretonne spécialisée dans les solutions numériques libres.