Aide-mémoire des formats de tâche Obsidian
Obsidian n’a pas de syntaxe de tâche intégrée au-delà de la case à cocher. Les plugins ajoutent le reste, et ils le font de quatre manières différentes. Cette page liste chaque champ de chaque manière, avec les caractères exacts à saisir.
Vérifié en octobre 2026 avec Obsidian Tasks 8.6, Task Genius 9.13, TaskNotes 4.14 et la documentation de Dataview. La documentation de chaque plugin est liée en bas de page et prévaut en cas de désaccord avec cette page.
L’impression de cette page donne une référence compacte, sans la navigation du site.
Anatomie d’une ligne de tâche
Une tâche est un élément de liste avec une case à cocher. Après la description viennent les champs, chacun étant un symbole suivi d’une valeur. Obsidian Tasks lit la ligne depuis la droite : les champs se placent donc à la fin, après le texte, et tout texte non reconnu entre deux champs arrête la lecture à cet endroit.
La même tâche dans chaque format de ligne :
- [ ] Pay rent ⏫ 🔁 every month ➕ 2026-01-02 ⏳ 2026-01-14 📅 2026-01-15 - [ ] Pay rent [priority:: high] [repeat:: every month] [created:: 2026-01-02] [scheduled:: 2026-01-14] [due:: 2026-01-15] - [ ] Pay rent #project/Home @bank ⏫ 📅 2026-01-15 09:00 [repeat:: every month] Un fichier de tâche conserve les mêmes informations dans le frontmatter YAML. Voir la section sur les fichiers de tâche plus bas.
Les champs, côte à côte
Les dates sont toujours au format YYYY-MM-DD. La colonne Dataview utilise des crochets. Obsidian Tasks et Dataview lisent aussi les parenthèses, (due:: 2026-01-15) ; Task Genius ne lit que les crochets. Task Genius lit l’emoji et la forme à crochets : sa colonne ne liste donc que ce qu’il ajoute ou écrit autrement.
Faites défiler latéralement sur un écran étroit.
| Champ | Emoji Obsidian Tasks | Style Dataview | Task Genius |
|---|---|---|---|
| Date d’échéance La date limite. Obsidian Tasks lit aussi 📆 et 🗓 comme échéance. | 📅 2026-01-15 | [due:: 2026-01-15] | Identique aux deux autres |
| Date planifiée Le jour où vous prévoyez de travailler dessus. Obsidian Tasks lit aussi ⌛. | ⏳ 2026-01-14 | [scheduled:: 2026-01-14] | Identique aux deux autres |
| Date de début La tâche n’est pas réalisable avant ce jour. | 🛫 2026-01-10 | [start:: 2026-01-10] | Identique aux deux autres |
| Date de création Ajoutée à la création de la tâche, si le plugin est réglé pour le faire. | ➕ 2026-01-02 | [created:: 2026-01-02] | Identique aux deux autres |
| Date d’achèvement Ajoutée quand vous cochez la tâche. Dans le style Dataview, la clé est completion, pas done. | ✅ 2026-01-15 | [completion:: 2026-01-15] | Identique aux deux autres |
| Date d’annulation S’associe à un statut annulé comme [-]. | ❌ 2026-01-15 | [cancelled:: 2026-01-15] | Identique aux deux autres |
| Priorité Cinq niveaux, du plus haut au plus bas. La priorité normale ne s’écrit pas du tout. | 🔺 highest ⏫ high 🔼 medium 🔽 low ⏬ lowest | [priority:: highest] [priority:: high] [priority:: medium] [priority:: low] [priority:: lowest] | [#A] |
| Récurrence Obsidian Tasks et le style Dataview utilisent des mots simples qui commencent par every. Task Genius lit ces règles et les règles iCalendar. Voir la section sur la récurrence. | 🔁 every week on Sunday when done | [repeat:: every week on Sunday when done] | [recurrence:: FREQ=WEEKLY;BYDAY=SU] |
| À l’achèvement Ce qu’il advient d’une tâche une fois terminée. Obsidian Tasks gère keep et delete. | 🏁 delete 🏁 keep | [onCompletion:: delete] | Identique aux deux autres |
| ID de tâche Lettres, chiffres, trait d’union et tiret bas uniquement. | 🆔 abc123 | [id:: abc123] | Identique aux deux autres |
| Dépend de Un ou plusieurs ID de tâche, séparés par des virgules. | ⛔ abc123,def456 | [dependsOn:: abc123,def456] | Identique aux deux autres |
| Heure Obsidian Tasks n’a pas de champ d’heure. Task Genius lit une heure après la date. | Non disponible | Non disponible | 📅 2026-01-15 14:30 [due:: 2026-01-15 14:30] |
| Projet et contexte Obsidian Tasks n’a pas de champ projet ou contexte ; utilisez des tags. Task Genius lit ces champs. | Non disponible | Non disponible | #project/Website @phone [project:: Website] [context:: phone] |
Ordre dans lequel Obsidian Tasks écrit les champs
Quand Obsidian Tasks écrit une ligne, il place d’abord l’ID, les dépendances, la priorité, la récurrence et l’action à l’achèvement, puis les dates de création, de début, planifiée et d’échéance, puis les dates d’annulation et d’achèvement. Écrire à la main dans un autre ordre fonctionne tant que chaque champ reste à la fin de la ligne.
Caractères de statut
Le caractère entre les crochets est le statut. Seuls l’espace et le x sont universels. Tout le reste est une convention à laquelle un plugin, un thème ou une collection de statuts donne un sens.
| Caractère | Sens habituel | Qui le comprend |
|---|---|---|
[ ] | À faire | Tout, y compris Obsidian lui-même |
[x] | Terminée (x ou X) | Tout, y compris Obsidian lui-même |
[/] | En cours | Task Genius par défaut, Obsidian Tasks comme statut personnalisé |
[-] | Annulée ou abandonnée | Task Genius par défaut, Obsidian Tasks comme statut personnalisé |
[>] | En cours (Task Genius) ou transmise | Task Genius par défaut, une convention ailleurs |
[<] | Planifiée | Une convention issue de collections de statuts et de thèmes, pas un réglage par défaut de Task Genius ; un statut personnalisé dans Obsidian Tasks |
[?] | Planifiée | Task Genius par défaut, souvent lu comme une question ailleurs |
[!] | Importante | Une convention issue de collections de statuts et de thèmes, pas un réglage par défaut de Task Genius ; un statut personnalisé dans Obsidian Tasks |
Dans Obsidian Tasks, un caractère que vous n’avez pas configuré apparaît comme un statut inconnu (Unknown). Ajoutez-le dans les réglages Custom Statuses du plugin, ou chargez une collection de statuts toute faite.
Task Genius ne considère comme terminées que les tâches marquées x et X. Les fichiers TaskNotes n’utilisent pas du tout de caractères de case à cocher ; ils ont une propriété status, traitée plus bas.
Récurrence
C’est sur la récurrence que les formats diffèrent le plus. La même tâche hebdomadaire, écrite de quatre façons :
- [ ] Water plants 🔁 every week on Sunday when done 📅 2026-01-18 - [ ] Water plants [repeat:: every week on Sunday when done] [due:: 2026-01-18] - [ ] Water plants [recurrence:: FREQ=WEEKLY;BYDAY=SU] [due:: 2026-01-18] recurrence: "DTSTART:20260118;FREQ=WEEKLY;BYDAY=SU"
recurrence_anchor: completion Règles comprises par Obsidian Tasks
Chaque règle commence par le mot every. Ajoutez when done pour compter à partir du jour où vous terminez plutôt qu’à partir de la date d’origine.
every 3 days
every 10 days when done
every weekday
every week on Sunday
every week on Tuesday, Friday
every 2 weeks
every 3 weeks on Friday
every 2 months
every month on the 1st
every month on the last
every month on the last Friday
every month on the 2nd last Friday
every January on the 15th
every April and December on the 1st and 24th
every year Comment l’achèvement se comporte
- Obsidian Tasks : cocher une tâche récurrente marque cette ligne comme terminée et ajoute une nouvelle ligne, au-dessus par défaut, avec les dates avancées. Un réglage place plutôt la nouvelle ligne en dessous.
- Obsidian Tasks : une tâche récurrente a besoin d’au moins une date d’échéance, planifiée ou de début. Sans cela, la règle n’a rien à déplacer.
- Obsidian Tasks : avec une règle mensuelle, une date qui n’existe pas (le 31 en avril) recule au dernier jour valide. Une règle qui nomme explicitement le 31 saute en revanche les mois qui n’en ont pas.
- Obsidian Tasks : la nouvelle ligne abandonne tout ID et tout champ depends-on, pour qu’une dépendance ne bloque pas indéfiniment.
- TaskNotes : le fichier reste une seule tâche. Les dates terminées et ignorées vont dans complete_instances et skipped_instances, et le calendrier avance.
- Task Genius : la date suivante vient d’une règle iCalendar ou d’une formule simple comme every 2 weeks. Les formules plus riches d’Obsidian Tasks, comme every weekday ou the last Friday of the month, ne sont pas lues de la même façon : testez-en quelques-unes avant de vous y fier.
- Gardez les tâches récurrentes hors des notes quotidiennes. Une ligne récurrente dans une note quotidienne est copiée dans la note de chaque jour.
Fichiers de tâche : frontmatter TaskNotes
TaskNotes stocke une tâche par note. Les informations vivent dans le frontmatter YAML et le corps est du texte libre. Un fichier compte comme une tâche s’il porte le tag ou la propriété définis dans les réglages du plugin, par défaut le tag task.
---
tags:
- task
title: Review quarterly report
status: in-progress
priority: high
due: 2026-01-15
scheduled: 2026-01-14
contexts:
- office
projects:
- "[[Q1 Planning]]"
timeEstimate: 90
recurrence: "DTSTART:20260115;FREQ=MONTHLY;BYMONTHDAY=15"
recurrence_anchor: scheduled
---
Notes, links and a checklist go in the body. Propriétés
| Propriété | Exemple | Signification |
|---|---|---|
| title | | Le nom de la tâche. |
| status | | Une valeur de votre liste de statuts. Par défaut : open, in-progress et done. |
| priority | | Une valeur de votre liste de priorités. Par défaut : low, normal et high. |
| due | | Date limite, sous forme de date ou de date et heure. |
| scheduled | | Le jour où vous prévoyez de travailler dessus. |
| completedDate | | Renseignée quand la tâche est terminée. |
| dateCreated | | Heure de création, sous forme d’horodatage ISO. |
| dateModified | | Dernière modification, sous forme d’horodatage ISO. |
| tags | | Une liste YAML, écrite sans le dièse. |
| contexts | | Une liste YAML de lieux ou de modes. |
| projects | | Une liste YAML de liens vers des notes de projet. |
| timeEstimate | | Un nombre de minutes. |
| recurrence | | Une règle iCalendar. DTSTART fixe la date d’ancrage. |
| recurrence_anchor | | scheduled ou completion : le point à partir duquel la date suivante est comptée. |
| complete_instances | | Dates des occurrences terminées d’une tâche récurrente. |
| skipped_instances | | Dates des occurrences ignorées. |
| blockedBy | | Tâches à terminer d’abord, sous forme d’objets avec un uid, un type de relation et un écart facultatif. |
Les noms de propriété sont des réglages. Si vous renommez due en deadline dans le plugin, le fichier doit utiliser deadline.
Les listes doivent être des listes, même avec un seul élément. Une valeur simple là où une liste est attendue est la raison la plus courante pour laquelle un fichier de tâche n’apparaît pas dans une vue.
Pièges qui coûtent une soirée
- Obsidian Tasks lit et écrit un seul format à la fois. Si son réglage est sur Dataview, ses propres emoji ne sont plus lus tant que vous ne revenez pas en arrière.
- Dataview exige un double deux-points, [due:: 2026-01-15]. Un seul deux-points n’est pas un champ.
- Les crochets doivent correspondre. [due:: 2026-01-15) n’est pas lu.
- Les clés d’Obsidian Tasks sont sensibles à la casse dans le style Dataview : repeat, dependsOn et onCompletion fonctionnent, Repeat et dependson non. Task Genius compare les clés sans tenir compte de la casse.
- La clé de la date d’achèvement est completion. [done:: 2026-01-15] n’est qu’un champ inconnu.
- Dataview documente 🗓️ comme son raccourci d’échéance, alors qu’Obsidian Tasks écrit 📅. Si vous interrogez des dates en emoji avec Dataview, testez d’abord votre propre version. Les champs entre crochets évitent la question.
- Un texte collé peut contenir des espaces insécables ou un sélecteur de variante après un emoji. Obsidian Tasks ne les lit pas, et la ligne paraît normale à l’écran.
- Dataview n’a des raccourcis que pour cinq dates. La priorité et la récurrence n’en ont pas et exigent la forme à crochets.
- Un filtre global comme #task dans Obsidian Tasks lui fait ignorer toute case à cocher sans ce tag. Les tâches qui disparaissent des requêtes viennent souvent de là.
- Les lignes de case à cocher dans un bloc de code délimité ne sont des tâches dans aucun de ces plugins.
Sources de référence
Les plugins évoluent. Quand quelque chose ici semble faux pour votre version, fiez-vous à ces sources plutôt qu’à cette page.
- Obsidian Tasks : Tasks Emoji Format
- Obsidian Tasks : Dataview Format
- Obsidian Tasks : Recurring Tasks
- Obsidian Tasks : Statuses
- Dataview : Metadata on Tasks and Lists
- Dataview : Adding Metadata (inline fields)
- Documentation de Task Genius
- Task Genius sur GitHub
- Documentation de TaskNotes
- TaskNotes : Property Types Reference
Sur un téléphone
TaskForge, une application distincte pour iPhone, iPad, Mac, Android et Windows, lit les formes emoji, Dataview et Task Genius ci-dessus ainsi que les fichiers de tâche de style TaskNotes depuis le même dossier. Ce n’est pas un plugin Obsidian et il n’a aucun lien avec Obsidian. Vous n’en avez pas besoin pour utiliser quoi que ce soit sur cette page.
Questions fréquentes
Quelle est la syntaxe Obsidian Tasks pour une date d’échéance ?
Saisissez l’emoji calendrier, une espace et la date : - [ ] Pay rent 📅 2026-01-15. Dans le style Dataview, c’est [due:: 2026-01-15]. Les deux utilisent YYYY-MM-DD.
Quels sont les emoji de priorité d’Obsidian Tasks ?
🔺 la plus haute, ⏫ haute, 🔼 moyenne, 🔽 basse et ⏬ la plus basse. La priorité normale n’a pas de symbole. Dans le style Dataview, le champ est priority et les valeurs sont highest, high, medium, low et lowest.
Puis-je utiliser des champs Dataview dans les notes plutôt que des emoji dans Obsidian Tasks ?
Oui. Réglez le format de tâche dans les réglages d’Obsidian Tasks sur Dataview et il lit et écrit des champs de style [due:: 2026-01-15]. Il ne lit que le format choisi : les lignes en emoji existantes doivent donc être converties. Voir la page de conversion pour les recettes.
Comment écrire une tâche récurrente dans Obsidian ?
Avec Obsidian Tasks, ajoutez 🔁 et une règle qui commence par every, plus au moins une date : - [ ] Water plants 🔁 every week on Sunday 📅 2026-01-18. Avec TaskNotes, réglez la propriété recurrence sur une règle iCalendar comme FREQ=WEEKLY;BYDAY=SU.
Quels caractères de statut une tâche Obsidian peut-elle avoir ?
N’importe quel caractère unique tient entre les crochets. L’espace et le x sont standard. Des caractères comme /, - et > ne signifient quelque chose que lorsqu’un plugin ou un thème les définit.
Task Genius utilise-t-il la même syntaxe qu’Obsidian Tasks ?
Il lit les mêmes emoji et la forme à crochets de Dataview sur une même ligne : un coffre écrit pour Obsidian Tasks fonctionne donc. Il ajoute une heure après la date, des champs projet et contexte, et des règles de récurrence iCalendar. Le format qu’il écrit est un réglage.