Obsidian Bases : démarrer avec une première base

Obsidian Bases est un plugin principal d’Obsidian, disponible depuis la version 1.9.10 (août 2025). Il affiche les notes d’un coffre sous forme de vues (tableau, liste, cartes, kanban ou carte géographique), filtrées, triées et groupées selon leurs propriétés. Vous pouvez modifier ces propriétés directement dans la vue. Les données restent dans vos fichiers Markdown : la base décrit seulement la vue, dans un fichier .base ou dans un bloc base placé dans une note.

Ce guide vous mène jusqu’à une première base, puis vous aide à choisir la bonne vue et à savoir quand un autre outil convient mieux. Pour la suite, la référence de syntaxe d’Obsidian Bases détaille le YAML, les filtres, les formules et toutes les fonctions. Vues et propriétés dans Obsidian Bases explique comment régler chaque vue, concevoir des propriétés fiables et adapter des recettes. Dataview couvre les requêtes que Bases ne fait pas ; Meta Bind ajoute des champs et des boutons pour modifier une propriété depuis une note.

En bref

• Bases est inclus dans Obsidian : il suffit de l’activer dans les plugins principaux.
• Une ligne, une carte ou un point sur la carte correspond à un fichier du coffre.
• Les colonnes viennent des propriétés de vos notes, des informations du fichier (nom, dossier, dates) et de formules.
• Vérifié le 9 novembre 2026 contre la documentation d’Obsidian, à jour d’Obsidian 1.15.1. Exemples testés le 9 novembre 2026 dans Obsidian 1.15.0 (Windows 11).

Sommaire 9 sections

1. Ce que fait Obsidian Bases, et ce qu’il ne fait pas
2. Avant de commencer
3. Créer votre première base en cinq étapes
4. Les cinq mises en page : laquelle choisir ?
5. Filtres, formules et résumés : l’essentiel
6. Bases ou Dataview : lequel utiliser ?
7. Erreurs fréquentes
8. Aller plus loin
9. Questions fréquentes

Ce que fait Obsidian Bases, et ce qu’il ne fait pas

Une base répond à une question du type « quelles notes remplissent ces conditions, et que veut-on voir d’elles ? ». Elle part de tous les fichiers du coffre : la documentation précise qu’une base sans filtre affiche tous les fichiers, pièces jointes comprises. Les filtres réduisent cet ensemble (un dossier, un tag, une valeur de propriété), puis chaque vue choisit ses colonnes, son tri et ses groupes.

Ce que Bases permet, d’après la documentation :

• afficher les notes en tableau, liste, cartes, kanban ou carte géographique, avec plusieurs vues dans une même base ;
• modifier les propriétés depuis la vue : une cellule de tableau, ou une carte de kanban qu’on déplace d’une colonne à l’autre ;
• créer une note depuis la vue avec le bouton « Nouveau » ;
• calculer des colonnes avec des formules et des résumés en bas de colonne (somme, moyenne, nombre de valeurs…) ;
• copier une vue pour la coller dans une note ou un tableur, ou l’exporter en CSV.

Ce que Bases ne fait pas :

• interroger des tâches ou des éléments de liste. Une ligne correspond à un fichier entier, jamais à une case à cocher dans une note ;
• lire les champs en ligne du type statut:: en cours : Bases lit les propriétés du frontmatter, pas le corps de la note ;
• afficher des propriétés imbriquées : Obsidian ne les prend pas en charge dans l’éditeur de propriétés (documentation « Properties »).

Ces trois cas relèvent de Dataview (voir la section « Bases ou Dataview »).

Avant de commencer

• Version. Bases existe depuis Obsidian 1.9.10. Le kanban demande la version 1.14 ou plus récente, la liste et la carte géographique la 1.10 selon la documentation ; le plugin Maps 0.2.2, nécessaire à la carte, demande lui-même Obsidian 1.13.1 au minimum.
• Activer Bases : dans les réglages, section des plugins principaux (« Core plugins » dans la documentation), activez Bases.
• Libellés. Les menus cités dans ce guide sont ceux de l’interface française d’Obsidian 1.15.0. Quelques mots y restent en anglais : les opérateurs de filtre (« in folder », « has tag »), les noms des résumés (« Sum », « Average ») et le message « Valid formula ».
• Pas d’autre plugin requis. Le plugin principal « Vue des propriétés » (« Properties view » en anglais) sert à lister et à gérer les propriétés du coffre. Il est utile, mais Bases n’en a pas besoin : une base s’ouvre et fonctionne quand il est désactivé.
• Préparez deux ou trois propriétés cohérentes. Dans Obsidian, un type (texte, nombre, date…) attribué à un nom de propriété vaut pour tout le coffre. Une propriété statut en texte partout donnera des filtres et des tris fiables. La conception des propriétés est détaillée dans Vues et propriétés.

Créer votre première base en cinq étapes

Exemple pédagogique : un dossier Lectures dont les notes portent trois propriétés, statut (texte : « à lire », « en cours », « lu »), auteur (texte) et fini_le (date). Remplacez ces noms par les vôtres.

1. Créer la base. Trois chemins mènent au même résultat :

• palette de commandes → « Bases: Créer une nouvelle base », ou « Bases: Insérer une nouvelle base » pour créer la base directement dans la note ouverte ;
• explorateur de fichiers → clic droit sur un dossier → « Nouvelle base » ;
• ruban vertical → « Créer une nouvelle base ».

Depuis la palette ou le ruban, le fichier .base va là où le coffre range les nouvelles notes : dans le dossier de la note active si le réglage des nouvelles notes vaut « même dossier que le fichier actuel », sinon dans le dossier fixé par ce réglage. Le clic droit sur un dossier évite la question.

Nommez le fichier Lectures.base. Sa première vue s’appelle « Vue » : pour la renommer « Toutes les lectures », faites un clic droit sur son nom, en haut à gauche, et changez le nom en tête du panneau « Configurer la vue ».

2. Filtrer les notes. Ouvrez le menu Filtre. La section « Toutes les vues » s’applique à toutes les vues de la base, « Cette vue » à la vue active seulement. Dans « Toutes les vues », ajoutez un filtre : propriété « fichier », opérateur « in folder », dossier Lectures. Le bouton de code de la ligne affiche la condition écrite : file.inFolder("Lectures"). Vous pouvez aussi la taper directement à cet endroit. Le chemin part de la racine du coffre : si Lectures est rangé dans Projets, la condition devient file.inFolder("Projets/Lectures"). Le fichier Lectures.base est lui-même dans le dossier, donc il apparaît dans les résultats ; une deuxième condition, propriété « extension », opérateur « is », valeur md, ne garde que les notes.

3. Choisir les colonnes. Ouvrez le menu Propriétés et cochez statut, auteur et fini_le en plus du nom du fichier (colonne « name »). Glissez-les pour changer leur ordre. Cet ordre règle l’affichage des colonnes, pas le tri des lignes.

4. Trier et grouper. Dans le menu Trier, choisissez « Ajouter un tri », la propriété fini_le, puis « Du plus récent au plus ancien ». Dans le menu Groupe, sous « Grouper par », choisissez statut : les notes se rangent en sections « à lire », « en cours » et « lu », plus une section « Aucun » pour les notes sans statut. Une vue accepte plusieurs tris, mais un seul regroupement.

5. Ajouter une deuxième vue. Cliquez sur le nom de la vue, puis « Ajouter une vue » : la vue « Vue 2 » est créée et le panneau « Configurer la vue » s’ouvre. Nommez-la « Par statut » et choisissez la mise en page « Kanban » (Obsidian 1.14 ou plus récent). Le kanban reste vide, avec le message « Ajouter des colonnes », tant que vous n’avez pas choisi la propriété de groupe : menu Groupe, « Grouper par » statut. Chaque valeur devient une colonne ; les notes sans valeur vont dans la colonne « Aucun ». Déplacer une carte d’une colonne à l’autre modifie la propriété statut dans la note. Avant la version 1.14, choisissez la mise en page « Galerie » (Cards en anglais).

Obsidian enregistre ces réglages dans Lectures.base. Vous n’avez pas besoin d’écrire ce fichier, mais le lire aide à comprendre la suite. Le résultat ressemble à ceci :

filters:
  and:
    - file.inFolder("Lectures")
    - file.ext == "md"
views:
  - type: table
    name: Toutes les lectures
    order:
      - file.name
      - statut
      - auteur
      - fini_le
    sort:
      - property: fini_le
        direction: DESC
    groupBy:
      property: statut
      direction: ASC
  - type: kanban
    name: Par statut
    groupBy:
      property: statut
      direction: ASC

La clé sort est celle qu’écrit l’application dans les fichiers .base ; la page de syntaxe officielle ne la décrit pas encore. Les autres clés sont documentées. Obsidian 1.15.0 range les clés d’une vue dans un autre ordre (type, name, groupBy, order, sort) ; cet ordre n’a pas d’importance. Le détail de chaque section se trouve dans la référence de syntaxe.

Afficher la base dans une note ou dans la barre latérale

• Dans une note, ![[Lectures.base]] affiche la première vue de la base, et ![[Lectures.base#Par statut]] une vue précise.
• Un bloc de code base placé dans une note contient la même syntaxe qu’un fichier .base. Il sert pour une vue propre à cette note.
• Une base ouverte dans la barre latérale peut suivre la note active. Le mot-clé this désigne alors cette note : le filtre file.hasLink(this.file) liste les notes qui pointent vers la note active, comme le volet des rétroliens, avec les colonnes de votre choix. La forme courte file.hasLink(this) donne le même résultat dans Obsidian 1.15.0. La recette complète est dans Vues et propriétés.

Les cinq mises en page : laquelle choisir ?

Chaque vue d’une base a une mise en page. La documentation d’Obsidian en décrit cinq, et des plugins communautaires peuvent en ajouter.

Mise en page	Depuis	À choisir pour…	À savoir
Tableau (Table)	1.9	comparer des notes sur plusieurs propriétés et les modifier en série	résumés en bas de colonne, copier-coller de cellules, raccourcis clavier
Liste (List)	1.10	une lecture compacte, à puces ou numérotée	les propriétés peuvent s’afficher en retrait sous chaque note
Galerie (Cards)	1.9	des cartes : livres, projets, personnes avec une image	l’image vient d’une propriété : pièce jointe, URL ou couleur hexadécimale
Kanban	1.14	suivre un état (à faire, en cours, fait)	déplacer une carte modifie la propriété de groupe ; impossible si le groupe est une formule
Carte géographique (Map)	1.10	des lieux avec des coordonnées	demande le plugin officiel Maps, à installer depuis les plugins communautaires ; la mise en page s’appelle alors « Map » dans la liste

Les réglages de chaque mise en page (hauteur de ligne, taille de carte, largeur de colonne, coordonnées…) sont détaillés dans Vues et propriétés.

Filtres, formules et résumés : l’essentiel

Filtres. Un filtre a trois éléments : une propriété, un opérateur (qui dépend du type de la propriété) et une valeur. Les opérateurs restent en anglais dans l’interface (« in folder », « has tag », « is », « links to »). Les groupes combinent les conditions : « Toutes les conditions suivantes sont vraies », « Au moins l’une des conditions suivantes est vraie », « Aucune des conditions suivantes n’est vraie ». Les filtres de « Toutes les vues » et ceux de la vue active s’additionnent : une note doit satisfaire les deux. Depuis Obsidian 1.15 (2 novembre 2026), on peut réordonner les filtres en les faisant glisser par la poignée à gauche de chaque ligne, et les déplacer de la même façon d’une section à l’autre.

Formules. Une formule crée une colonne calculée, utilisable dans toutes les vues de la base. Ouvrez le menu Propriétés et ajoutez une formule (« Add formula » dans la documentation), donnez-lui un nom et écrivez l’expression ; le message « Valid formula » confirme que la syntaxe est valide. Deux exemples tirés de la documentation :

• if(due_date < now() && status != "Done", "Overdue", "") affiche « Overdue » quand l’échéance est passée et que la tâche n’est pas terminée ;
• file.mtime.relative() affiche depuis quand la note a été modifiée, dans la langue de l’interface (« il y a 7 minutes » en français, « 3 days ago » en anglais).

Une formule peut aussi lire les propriétés d’une note liée : avec project: "[[Refonte du site]]", l’expression project.asFile().properties.status affiche le statut du projet sur chaque tâche. La documentation prévient que ces valeurs se mettent à jour quand la note de la ligne change, pas forcément quand seule la note liée change.

Résumés. Dans un tableau, un clic droit sur l’en-tête d’une colonne puis « Résumer… » ajoute un calcul en bas de colonne : somme, moyenne, minimum, maximum, nombre de valeurs remplies ou vides, valeurs uniques, date la plus ancienne ou la plus récente, cases cochées. Les noms des calculs restent en anglais (« Sum », « Average », « Filled »…). Chaque vue a ses propres résumés.

La liste complète des fonctions, des opérateurs et des unités de durée est dans la référence de syntaxe.

Bases ou Dataview : lequel utiliser ?

Les deux outils affichent des notes selon leurs métadonnées, mais ils ne lisent pas les mêmes données et un seul des deux modifie les notes depuis la vue.

Besoin	Bases	Dataview
Statut	plugin principal, maintenu par Obsidian	plugin communautaire ; dernière version publiée : 0.5.70, le 7 avril 2025
Unité affichée	un fichier par ligne	des fichiers, mais aussi des tâches et des éléments de liste (requête TASK)
Données lues	propriétés du frontmatter, informations du fichier, formules	frontmatter et champs en ligne clé:: valeur
Modifier depuis la vue	oui : cellules de tableau, cartes de kanban	non prévu pour cela
Mises en page	tableau, liste, cartes, kanban, carte géographique	LIST, TABLE, TASK, CALENDAR
Logique avancée	formules et fonctions intégrées	langage de requête et JavaScript (DataviewJS)

Choisissez Bases quand vous voulez voir, trier et modifier des notes par leurs propriétés, sans dépendre d’un plugin tiers. Gardez Dataview pour les tâches réparties dans vos notes, les champs en ligne et les calculs que seul JavaScript permet. Les deux plugins peuvent coexister dans un même coffre. Pour modifier une propriété depuis le corps d’une note avec un champ, une liste ou un bouton, Meta Bind complète Bases.

Erreurs fréquentes

• Rien n’apparaît. Vérifiez l’orthographe exacte du dossier ou du tag, puis le chemin : file.inFolder("Lectures") ne trouve pas un dossier Projets/Lectures, il faut le chemin complet depuis la racine du coffre. Vérifiez enfin la section du filtre : un filtre placé dans « Cette vue » ne concerne que la vue active.
• Tous les fichiers du coffre apparaissent, images comprises. La base n’a pas de filtre : elle liste aussi les images et les fichiers .base. Ajoutez au moins un dossier, un tag ou file.ext == "md".
• Colonnes vides. La propriété manque dans certaines notes, ou son nom diffère (Statut et statut, par exemple).
• Le kanban refuse de déplacer une carte. Le groupe porte sur une formule ou sur une information de fichier autre que le dossier, ou la note n’est pas un fichier Markdown. Déplacer une carte dans un kanban groupé par file.folder déplace le fichier dans ce dossier.
• Le filtre « exists » a disparu. Depuis Obsidian 1.9.8, on écrit « file has property » dans l’interface, soit file.hasProperty("statut").
• Une ancienne formule d’âge affiche une erreur. Dans Obsidian 1.15.0, ((now() - file.ctime) / 86400000).toFixed(0) affiche « Impossible de trouver la fonction “toFixed” sur le type Duration » : soustraire deux dates donne une durée, et non un nombre de millisecondes. La forme à jour est dans la référence de syntaxe.
• La base est lente. Évitez file.backlinks sur un grand coffre : la documentation le dit coûteux et non rafraîchi automatiquement. Préférez file.links dans l’autre sens, limitez le nombre de lignes avec le menu Résultats (« Limiter le nombre de résultats ») ou la clé limit, et simplifiez les formules.
• L’image ne s’affiche pas en cartes. La propriété choisie comme image doit contenir un lien vers une pièce jointe ("[[couverture.jpg]]", entre guillemets), une URL ou une couleur hexadécimale.

Aller plus loin

• Référence de syntaxe d’Obsidian Bases : structure d’un fichier .base, filtres, opérateurs et dates, toutes les fonctions par type, formules sur les notes liées, résumés.
• Vues et propriétés dans Obsidian Bases : réglages des cinq mises en page, conception des propriétés et recettes à adapter (pipeline éditorial, CRM léger, lectures, kanban de projets, rétroliens enrichis).
• Dataview : requêtes sur les tâches, champs en ligne, DataviewJS.
• Meta Bind : champs et boutons dans une note pour modifier ses propriétés.

Pour les autres fonctions d’Obsidian, revenez au guide Obsidian.

Questions fréquentes

Obsidian Bases est-il gratuit ?

Bases est un plugin principal : il est inclus dans Obsidian et s’active dans les réglages, sans installation. Seule la carte géographique demande un plugin supplémentaire, Maps, publié par l’équipe d’Obsidian dans les plugins communautaires.

Où sont stockées les données d’une base ?

Dans vos notes. Une base ne contient que la description des vues (filtres, formules, colonnes, tris) au format YAML. Supprimer un fichier .base ne supprime aucune note ; modifier une cellule modifie la propriété dans la note correspondante.

Bases remplace-t-il Dataview ?

Pour afficher et modifier des notes selon leurs propriétés, souvent oui. Pour interroger des tâches, lire des champs en ligne ou écrire du JavaScript, non. Le tableau de la section « Bases ou Dataview » détaille le choix.

Bases fonctionne-t-il sur mobile ?

La documentation décrit l’usage sur téléphone : les menus Résultats, Trier, Groupe et Propriétés y sont regroupés dans un seul menu (« Display » dans la documentation anglaise). Ce point n’a pas été testé sur mobile.

Peut-on réutiliser une base dans un autre coffre ?

Oui : un fichier .base est un fichier texte. Adaptez ensuite les noms de dossiers, de tags et de propriétés, qui changent d’un coffre à l’autre.

Peut-on exporter le contenu d’une vue ?

Oui. Le menu Résultats propose « Copier dans le presse-papier », pour coller la vue dans une note ou un tableur (le texte copié est séparé par des tabulations), et « Exporter en CSV… ».

---

Sources : documentation d’Obsidian (Bases, création, vues, syntaxe, formules, propriétés) et journal des versions, consultés le 9 novembre 2026 (Obsidian 1.15.1). Documentation de Dataview, consultée le même jour. Les exemples de cette page ont été testés le 9 novembre 2026 dans Obsidian 1.15.0 (Windows 11). Les raccourcis clavier du tableau, l’usage sur mobile et l’import d’un fichier .base restent décrits d’après la documentation. Essayez les exemples d’abord sur une copie de votre coffre.