Propriétés - Aide Obsidian
Propriétés
permalink: properties
cssclasses:
- soft-embed
description: 'Les propriétés vous permettent d''organiser les informations relatives à une note. Les propriétés contiennent des données structurées telles que du texte, des liens, des dates, des cases à cocher et des nombres.'
publish: true
mobile: false
localized: '2026-03-18'
Les propriétés vous permettent d'organiser les informations relatives à une note. Les propriétés contiennent des données structurées telles que du texte, des liens, des dates, des cases à cocher et des nombres. Les propriétés peuvent également être utilisées en combinaison avec des Modules complémentaires capables d'exploiter vos données structurées.
Ajouter des propriétés à une note
Il existe plusieurs façons d'ajouter une propriété à une note :
- Utiliser la commande Ajouter une propriété de fichier.
- Utiliser le raccourci clavier
Cmd/Ctrl+;. - Choisir Ajouter une propriété de fichier dans le menu Plus d'actions (accessible via l'icône des trois points ou en faisant un clic droit sur l'onglet).
- Taper
---tout au début d'un fichier.
Une fois que vous avez ajouté une propriété, une ligne apparaît en haut du fichier avec deux champs : le nom de la propriété et la valeur de la propriété.
Pour le nom, vous pouvez choisir ce que vous voulez. Obsidian fournit plusieurs propriétés par défaut : tags, cssclasses et aliases.
Une fois le nom de la propriété choisi, vous pouvez lui attribuer une valeur.
Types de propriétés
En plus d'un nom et d'une valeur, les propriétés ont également un type. Le type d'une propriété détermine le genre de valeurs qu'elle peut stocker et la façon dont Obsidian les traite. Pour changer le type d'une propriété, cliquez sur l'icône de type à côté du nom de la propriété et sélectionnez une option différente. Vous pouvez également gérer les types de propriétés à l'aide du module principal Vue des propriétés.
Obsidian prend en charge les types de propriétés suivants :
Une fois qu'un type de propriété est attribué à un nom de propriété, toutes les propriétés portant ce nom dans votre coffre utiliseront le même type.
Utilisations avancées
Rechercher des propriétés
Les propriétés disposent de leur propre syntaxe de recherche que vous pouvez utiliser avec d'autres termes et opérateurs de recherche. Voir la syntaxe de recherche pour les propriétés.
Modèles
Vous pouvez ajouter des propriétés aux Modèles.
Lorsque vous insérez un modèle dans la note active, toutes les propriétés du modèle sont ajoutées à la note. Obsidian fusionne également toutes les propriétés existantes dans votre note avec les propriétés du modèle.
Renommer des propriétés
Vous pouvez renommer une propriété en faisant un clic droit dessus dans la vue de toutes les propriétés.
Modes d'affichage
Vous pouvez changer la façon dont les propriétés sont affichées dans votre note en allant dans Paramètres → Éditeur → Propriétés dans le document. Les options sont :
- Visible (par défaut) – affiche les propriétés en haut de la note, s'il y en a.
- Masqué – masque les propriétés, qui peuvent toujours être affichées dans la barre latérale via la Vue des propriétés.
- Source – affiche les propriétés au format YAML en texte brut.
Extraits CSS
Vous pouvez utiliser les Extraits CSS pour modifier l'apparence de notes spécifiques.
Fonctionnalités non prises en charge
Quelques fonctionnalités ne sont actuellement pas prises en charge dans Obsidian :
- Propriétés imbriquées : Pour visualiser les propriétés imbriquées, nous recommandons d'utiliser le mode source.
- Modification en masse des propriétés : Pour une modification en masse approfondie en dehors de la Vue des propriétés, nous recommandons d'utiliser des outils de modification en masse comme VSCode, des scripts et des modules complémentaires.
- Markdown dans les propriétés : C'est une limitation intentionnelle car les propriétés sont conçues pour de petites informations atomiques lisibles à la fois par les humains et les machines.
Raccourcis clavier
Ajouter une propriété
| Action | Raccourci clavier |
|---|---|
| Ajouter une nouvelle propriété | Cmd + ; |
Naviguer entre les propriétés
Lorsqu'une propriété est sélectionnée
| Action | Raccourci clavier |
|---|---|
| Sélectionner la propriété suivante | Flèche bas ou Tab |
| Sélectionner la propriété précédente | Flèche haut ou Maj+Tab |
| Aller à l'éditeur | Alt+Flèche bas |
Sélectionner des propriétés
| Action | Raccourci clavier |
|---|---|
| Étendre la sélection vers le haut | Maj+Flèche haut |
| Étendre la sélection vers le bas | Maj+Flèche bas |
| Tout sélectionner | Cmd+A |
Modifier des propriétés
| Action | Raccourci clavier |
|---|---|
| Modifier le nom de la propriété | Flèche gauche |
| Modifier la valeur de la propriété | Flèche droite |
| Sélectionner la propriété | Échap |
| Supprimer la propriété | Cmd+Retour arrièresi des propriétés sont sélectionnées, la sélection sera supprimée à la place. |
| Annuler | Cmd+Z |
| Rétablir | Cmd+Maj+Z |
Vim (avancé)
| Action | Raccourci clavier |
|---|---|
| Descendre | j |
| Monter | k |
| Sélectionner la clé | h |
| Sélectionner la valeur | l |
| Sélectionner la valeur (curseur à la fin) | A |
| Sélectionner la valeur (curseur au début) | i |
| Créer une nouvelle propriété | o |
Format des propriétés
Les propriétés sont stockées au format YAML en haut du fichier. YAML est un format populaire facile à lire pour les humains comme pour les ordinateurs.
Les noms de propriétés sont séparés de leurs valeurs par un deux-points suivi d'un espace :
---
name: value
---
Bien que l'ordre des paires nom-valeur n'ait pas d'importance, chaque nom doit être unique au sein d'une note. Par exemple, vous ne pouvez pas avoir plus d'une propriété tags.
Les valeurs peuvent être du texte, des nombres, des cases à cocher, des dates, des dates et heures ou des listes.
Texte
Les propriétés de type texte contiennent une seule ligne de texte. La mise en forme Markdown n'est pas rendue dans les propriétés de type texte. Les hashtags ne créent pas de mots-clés lorsqu'ils sont utilisés dans les propriétés de type texte.
Les propriétés de type texte peuvent contenir des URL et des Liens internes en utilisant la syntaxe [[Lien]]. Les Liens internes dans les propriétés de type texte doivent être entourés de guillemets. Obsidian les ajoutera automatiquement si vous saisissez manuellement des liens internes dans les propriétés, mais veillez à les ajouter lorsque vous utilisez des modules de modèles.
---
title: A New Hope
link: "[[Episode IV]]"
url: https://www.example.com
---
Liste
Les propriétés de type liste contiennent plusieurs valeurs. Chaque valeur d'une liste apparaît sur sa propre ligne, précédée d'un tiret (-) et d'un espace.
Les valeurs de liste peuvent contenir du texte, des nombres et des Liens internes. Lorsque vous utilisez des Liens internes dans les propriétés de type liste, entourez-les de guillemets.
---
cast:
- Mark Hamill
- Harrison Ford
- Carrie Fisher
links:
- "[[Link]]"
- "[[Link2]]"
---
Nombre
Les propriétés de type nombre doivent toujours être un nombre littéral, pas une expression avec des opérateurs. Les entiers et les décimaux sont tous deux acceptés.
---
year: 1977
pie: 3.14
---
Case à cocher
Les propriétés de type case à cocher sont soit true, soit false. En aperçu en direct, cela s'affiche sous forme de case à cocher.
---
favorite: true
reply: false
last: # Valeur indéterminée ; souvent traitée comme false
Date
Les propriétés de type date sont stockées dans le format suivant :
---
date: 2020-08-21
---
Le sélecteur de date suit le format de date et d'heure par défaut de votre système d'exploitation. Vous pouvez le modifier dans les préférences de votre système :
Windows
Paramètres → Heure et langue → Langue et région → Format régional → Modifier les formats
Mac OS
Préférences Système → Langue et région → Format de date
Avec le module Notes quotidiennes activé, la propriété de date fonctionnera en plus comme un lien interne vers la note quotidienne correspondant à cette date.
Date et heure
Les propriétés de type date et heure incluent à la fois une date et une heure spécifique, stockées dans le format suivant :
---
time: 2020-08-21T10:30:00
---
Comme pour les propriétés de type date, le sélecteur de date et d'heure suit le format par défaut de votre système d'exploitation. Vous pouvez le modifier dans les préférences de votre système.
Mots-clés
Les propriétés de type mots-clés sont un type de propriété spécial utilisé exclusivement par la propriété tags. Ce type de propriété ne peut pas être attribué à d'autres propriétés.
Les propriétés de type mots-clés sont formatées sous forme de liste, chaque mot-clé sur sa propre ligne précédé d'un tiret (-) et d'un espace.
---
tags:
- journal
- personal
- draft
---
La propriété tags est l'une des Propriétés par défaut d'Obsidian. Consultez Mots-clés pour plus d'informations sur l'utilisation des mots-clés dans Obsidian.
Propriétés JSON
Bien que nous recommandions d'utiliser YAML pour définir les propriétés, vous pouvez également les définir en utilisant JSON :
---
{
"tags": ["journal"],
"publish": false
}
---
Notez que le bloc JSON sera lu, interprété et enregistré en YAML.
Propriétés par défaut
Obsidian est fourni avec un ensemble de propriétés par défaut :
| Propriété | Type | Description |
|---|---|---|
tags |
Liste | Voir Mots-clés. |
aliases |
Liste | Voir Alias. |
cssclasses |
Liste | Permet de styliser des notes individuelles à l'aide d' Extraits CSS. |
Propriétés pour Obsidian Publish
Les propriétés par défaut suivantes peuvent être utilisées avec Obsidian Publish :
| Propriété | Description |
|---|---|
publish |
Voir Sélectionner automatiquement les notes à publier. |
permalink |
Voir Permaliens. |
description |
Voir Description. |
image |
Voir Image. |
cover |
Voir Image. |
Propriétés obsolètes
Ces propriétés ont été rendues obsolètes dans Obsidian 1.4 et doivent être remplacées par leurs équivalents modernes. Leur prise en charge en tant que Propriétés par défaut est abandonnée dans Obsidian 1.9.
| Propriété | Description |
|---|---|
tag |
Alias obsolète pour tags. |
alias |
Alias obsolète pour aliases. |
cssclass |
Alias obsolète pour cssclasses. |
Si vous devez convertir les fichiers de votre coffre au format des Propriétés par défaut, vous pouvez utiliser l' Importateur depuis des fichiers Markdown pour modifier votre coffre en masse.