Callouts Obsidian : Syntaxe, Types, Exemples & CSS Personnalisé

Les callouts (blocs de mise en valeur) d’Obsidian vous permettent de mettre en évidence, de regrouper et de masquer certains contenus dans vos notes grâce à une syntaxe simple basée sur les blocs de citation (blockquotes). Que vous souhaitiez attirer l’attention sur des conseils d’examen, créer des listes de tâches repliables ou séparer les notes de l’auteur du texte du manuscrit, les callouts offrent un moyen flexible d’organiser visuellement l’information sans interrompre votre flux d’écriture.

Réponse rapide : Comment créer un Callout Obsidian ?

Oui. Les callouts Obsidian sont des blocs de citation stylisés utilisant > [!type] sur la première ligne. Ce guide vous fournit la syntaxe, des exemples à copier-coller, les types intégrés, les règles de repliement et d’imbrication, ainsi que les solutions aux problèmes de CSS personnalisé courants. Consultez la référence officielle des callouts pour vérifier la liste actuelle des types et des commandes de l’éditeur.

Voici la syntaxe de base pour créer un callout :

> [!note] Ceci est un callout.

• Utilisez > [!type] sur la première ligne d’un bloc de citation

• Remplacez note par un autre type comme tip, warning ou question

• Appuyez sur Entrée et continuez avec > pour ajouter du contenu multiligne

• En Live Preview, utilisez la palette de commandes et sélectionnez Insert callout pour insérer instantanément un bloc de callout par défaut. Vous pouvez également sélectionner du texte existant et exécuter la même commande pour l’envelopper dans un callout.

Que sont les Callouts Obsidian ?

Les callouts sont des blocs de citation stylisés qu’Obsidian affiche avec des couleurs, des icônes et un comportement de repliement optionnel. Ils ont été introduits vers le milieu de l’année 2022 et sont devenus une fonctionnalité essentielle pour organiser visuellement les notes.

Lorsqu’Obsidian rencontre un bloc de citation commençant par [!type], il le traite de manière spécifique et affiche un encadré au lieu d’une simple citation. Dans le corps du callout, vous pouvez utiliser la syntaxe Markdown standard, des wikilinks, des intégrations, des tâches, des blocs de code et des liens internes.

Visuellement, un callout s’affiche avec une barre latérale colorée, une icône (comme une ampoule pour les conseils ou un point d’exclamation pour les avertissements), une barre de titre optionnelle et le texte du corps en dessous.

Les usages courants comprennent :

• Résumer les points clés en haut des notes de réunion

• Mettre en évidence le matériel de révision dans les notes d’études

• Ajouter des blocs anti-spoiler dans les annotations de livres

Notez que les callouts ne s’affichent avec ce style que dans Obsidian. Dans les lecteurs Markdown simples ou sur GitHub, ils apparaissent sous forme de citations imbriquées ordinaires — le contenu reste lisible, mais sans la mise en forme visuelle.

Syntaxe et configuration des Callouts

Cette section couvre tous les éléments de syntaxe : type, titre, repliement et contenu.

La structure de base ressemble à ceci :

> [!note] Texte du titre
> Le contenu du corps se place ici
> - Les puces fonctionnent également

La première ligne contient trois éléments :

• L’identifiant de type entre crochets : [!note], [!warning], [!tip]

• Le marqueur de repliement optionnel : + ou - directement après le type (ex. [!tip]-)

• Le titre personnalisé optionnel après le type (ex. [!tip] Conseil pour l'examen)

Les lignes du corps commencent par > comme les blocs de citation habituels et peuvent inclure des listes, des blocs de code, des images ou des cases à cocher.

Le mot-clé du type est insensible à la casse — [!NOTE], [!Note] et [!note] fonctionnent de manière identique pour les callouts intégrés.

Modifier les titres des Callouts

Par défaut, Obsidian utilise le nom du type comme titre (ex. « Note » ou « Warning »).

Pour remplacer le titre par défaut :

> [!warning] À lire avant le déploiement

Comparez ces deux approches :

• > [!tip] s’affiche avec le titre par défaut « Tip »

• > [!tip] Workflow plus rapide affiche « Workflow plus rapide » à la place

Un callout contenant uniquement un titre fonctionne également — utilisez simplement une seule ligne comme > [!info] Configuration requise sans ligne de corps en dessous.

Les titres peuvent contenir des émojis, des wikilinks et des mises en forme comme du texte en gras.

Callouts Repliables (Collapsible)

L’ajout d’un signe plus ou d’un signe moins directement après le type contrôle si le callout peut être replié :

• > [!note]+ Toujours déplié par défaut

• > [!note]- Replié par défaut

Les deux marqueurs rendent le callout repliable. Le signe détermine s’il s’ouvre ou se ferme au départ.

Les cas d’usage pratiques pour les callouts repliables comprennent :

• Masquer les solutions détaillées dans les notes de révision

• Replier de longues listes de contrôle sous un en-tête [!todo]-

• Dissimuler des spoilers dans des fiches de lecture

En modes Lecture et Live Preview, les utilisateurs cliquent sur l’icône en forme de triangle pour déplier ou replier. En mode Code Source, le marqueur de repliement apparaît sous forme de Markdown brut.

Callouts Imbriqués

Vous pouvez imbriquer des callouts en plaçant un autre bloc de callout à l’intérieur du corps d’un callout parent.

Les lignes du callout interne utilisent un > supplémentaire pour chaque niveau d’imbrication :

> [!warning] Problème potentiel
>> [!tip] Voici une solution de contournement

Cela crée un callout d’avertissement contenant un conseil imbriqué. Autre exemple : un [!question] contenant des réponses [!example] imbriquées.

Limitez la profondeur d’imbrication pour conserver une bonne lisibilité — deux niveaux suffisent généralement.

Types de Callouts pris en charge dans Obsidian

Obsidian est livré avec des types intégrés, chacun associé à une couleur et une icône. Les types non pris en charge prennent par défaut le style de note.

Types par défaut courants et leurs alias :

• note : informations générales

• abstract / summary / tldr : résumés

• info : contexte supplémentaire

• todo : tâches et actions à mener

• tip / hint / important : conseils et points clés

• success / check / done : éléments terminés

• question / help / faq : questions

• warning / caution / attention : problèmes potentiels

• failure / fail / missing : informations manquantes

• danger / error : problèmes graves

• bug : bugs logiciels

• example : exemples de code ou de concepts

• quote / cite : citations mises en valeur

Différents thèmes communautaires peuvent restyler ces types, de sorte qu’un même [!warning] peut avoir un aspect différent selon le thème utilisé.

En Live Preview, faites un clic droit sur la gouttière d’un callout pour modifier son type depuis un menu contextuel au lieu d’éditer le Markdown manuellement.

Les types inconnus comme [!idea] s’affichent visuellement comme note, mais restent ciblables en CSS.

Quel Callout devez-vous utiliser ?

Le type contrôle le signal, pas seulement la couleur. Adoptez une convention simple qui vous indique quoi faire lorsque vous parcourez la note plus tard :

Ce que vous devez signaler	Bon type de départ	Motif utile
Un contexte ou une définition	info ou abstract	Placez l’explication à côté de l’affirmation qu’elle étaye.
Une action suivante	todo	Gardez la liste de contrôle près du contexte de projet.
Une décision ou un risque	question, warning ou type sur mesure	Rendez le point non résolu visible sans l’enterrer dans la prose.
Un détail secondaire	Repliable example ou note	Utilisez - pour garder les détails repliés par défaut.
Un résultat accompli	success ou done	Réservez-le à un résultat concret, pas à chaque phrase positive.

Pour un coffre-fort axé sur la productivité, un minimum pratique est todo pour les actions, warning pour les blocages, question pour les décisions ouvertes et summary pour les notes de synthèse.

Utilisations pratiques des Callouts dans votre coffre

Voici comment les callouts s’intègrent dans de vrais workflows :

• Études et apprentissage : Utilisez [!tip] pour les conseils d’examen, [!question]- pour les questions d’entraînement avec solutions repliées, [!summary] en haut des notes de cours.

• Développement logiciel : Ajoutez [!warning] autour des commandes destructrices, [!bug] pour les problèmes connus, [!example] pour les extraits d’utilisation d’API.

• Gestion de projets et de tâches : Stockez les listes de contrôle dans des callouts [!todo]+ regroupés par jalon, puis passez-les en [!success] une fois terminés.

• Écriture longue : Séparez les notes d’auteur à l’aide de [!note]- ou de types personnalisés, marquez les indices d’intrigue en [!clue] dans vos brouillons.

• Base de connaissances personnelle : Utilisez [!info] pour les faits clés, [!quote] pour les citations, [!danger] pour les avertissements critiques.

Combinez les callouts avec des modèles Obsidian prêts à l’emploi. Pour les flux de réunions, consultez notre guide des modèles de réunion Obsidian.

Callouts pour Tâches et Listes de contrôle

Les tâches placées dans des callouts se comportent comme des tâches Obsidian normales et apparaissent dans la recherche globale de tâches.

Un callout [!todo] regroupe des cases à cocher liées :

> [!todo]+ Liste de contrôle de la version 1.2
> - [ ] Mettre à jour le CHANGELOG pour la version du 2025-04-01
> - [ ] Exécuter les tests de régression

Passez le type de todo à success pour signaler visuellement la finalisation de l’ensemble du bloc.

Callouts dans les Workflows de Publication

Les callouts sont des outils d’édition interne et ne doivent souvent pas apparaître dans les exportations finales (livres, PDF, articles de blog).

Des plugins comme Longform permettent d’ajouter une étape de pré-traitement pour supprimer le balisage des callouts avant la compilation. Un script recherche les lignes commençant par > [! et retire la structure tout en conservant ou supprimant le corps selon le besoin.

Personnaliser les Callouts avec du CSS

Obsidian expose les callouts via des attributs data-callout, vous permettant de définir des types sur mesure en CSS.

La méthode :

1. Choisissez un identifiant de type personnalisé comme idea

2. Utilisez-le dans vos notes : > [!idea] Nouveau concept produit

3. En CSS, ciblez .callout[data-callout="idea"] avec des couleurs et une icône uniques

Obsidian utilise les icônes Lucide. L’API CSS prise en charge utilise --callout-color et --callout-icon ; la référence développeur pour les variables CSS de callouts liste les variables disponibles.

Exemples de Callouts Personnalisés Utiles

Idées concrètes de types personnalisés :

• [!clue] : Pour les auteurs suivant des indices d’intrigue à travers les chapitres.

• [!risk] : Dans la documentation technique pour signaler les risques techniques ou business.

• [!meeting] : Pour les synthèses d’actions en haut des notes de réunion datées.

• [!definition] : Dans une base de connaissances pour standardiser les entrées de terminologie.

Ajoutez ces styles en insérant un extrait (snippet) CSS dans le dossier .obsidian/snippets de votre coffre.

Dépannage du CSS personnalisé

Vérifiez les points suivants dans l’ordre :

1. Placez le fichier CSS dans le dossier .obsidian/snippets du coffre, activez-le dans Paramètres → Apparence → Snippets CSS, puis rechargez les snippets.
2. Assurez-vous que le type dans la note et le sélecteur correspondent exactement. Par exemple, [!decision] exige .callout[data-callout="decision"].
3. Conservez les noms de types personnalisés en minuscules aux deux endroits. Les identifiants intégrés sont insensibles à la casse, mais un rapport de dépannage du forum Obsidian montre qu’une différence de casse peut empêcher un sélecteur personnalisé de correspondre.
4. Utilisez une icône incluse dans votre version d’Obsidian.

Rechercher, Gérer et Exporter les Callouts

Recherchez des callouts avec des requêtes comme "[!todo]" pour trouver tous les callouts de tâches. Combinez avec des filtres de chemin : path:"Drafts" "[!clue]".

Limites et Compatibilité

Les callouts ne font pas partie du CommonMark standard. Dans des éditeurs comme Typora ou sur GitHub, ils se dégradent en simples citations imbriquées.

Certaines applications Markdown mobiles les affichent sous forme de texte brut — le contenu reste lisible mais sans couleurs ni icônes.

L’utilisation intensive de callouts imbriqués et repliables peut ralentir le rendu sur des appareils mobiles plus anciens.

Testez périodiquement vos exportations (PDF, DOCX, HTML) pour vérifier que le contenu critique à l’intérieur des callouts s’affiche correctement. Envisagez de maintenir un document de guide de style dans votre coffre afin que vos collaborateurs suivent les mêmes conventions.

Erreurs de syntaxe fréquentes

Le marqueur de repliement doit toucher l’identifiant de type :

> [!faq]- Replié par défaut
> Ce contenu démarre masqué.

> [!faq] - Replié par défaut contient un espace avant le tiret, ce n’est donc pas la syntaxe de repliement documentée. Si le repliement n’apparaît toujours pas, vérifiez que la note est en mode lecture ou en aperçu live et comparez le bloc à l’exemple officiel. Un signalement de 2024 sur le forum Obsidian a identifié cet espace superflu comme la cause d’un callout qui ne se repliait pas.

Les callouts sont une extension propre à Obsidian et ne font pas partie du CommonMark standard. Si un callout ressemble à une simple citation dans un autre éditeur Markdown, cela est normal ; le contenu reste lisible, mais le style et le comportement de repliement d’Obsidian ne sont pas transférés.

Conclusion

Les callouts Obsidian sont des blocs de citation améliorés qui vous permettent de mettre en valeur, regrouper et optionnellement masquer des informations sans perturber votre écriture.

Points clés :

• Maîtrisez la syntaxe de base : > [!type] Titre

• Choisissez un petit ensemble de types adaptés à votre workflow

• N’ajoutez du CSS personnalisé que lorsqu’il soutient votre processus

Si vous souhaitez que vos notes quotidiennes, projets, revues et modèles de réunion soient connectés dès le départ, Obsibrain fournit un système local prêt à l’emploi pour Obsidian.