Obsidian taakformaten spiekbrief
Obsidian heeft geen ingebouwde taaksyntax behalve het selectievakje. Plugins voegen de rest toe, en ze doen dat op vier verschillende manieren. Deze pagina somt alle velden van elke manier op, met de exacte tekens om te typen.
Gecontroleerd met Obsidian Tasks 8.6, Task Genius 9.13, TaskNotes 4.14 en de Dataview-documentatie in oktober 2026. De eigen docs van elke plugin staan onderaan en gaan voor als ze afwijken van deze pagina.
Als je deze pagina afdrukt, krijg je een compact overzicht zonder de sitenavigatie.
Anatomie van een taakregel
Een taak is een lijstitem met een selectievakje. Na de beschrijving komen de velden, elk een symbool gevolgd door een waarde. Obsidian Tasks leest de regel van rechts naar links, dus velden horen aan het eind, na de tekst, en niet-herkende tekst tussen twee velden stopt het lezen op dat punt.
Dezelfde taak in elk inline formaat:
- [ ] 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] Een taakbestand bewaart dezelfde gegevens in YAML-frontmatter. Zie de sectie over taakbestanden hieronder.
Velden, naast elkaar
Datums zijn altijd YYYY-MM-DD. De Dataview-kolom gebruikt vierkante haken. Obsidian Tasks en Dataview lezen ook ronde haken, (due:: 2026-01-15); Task Genius leest alleen vierkante haken. Task Genius leest de emoji en de vorm met haken, dus zijn kolom toont alleen wat hij toevoegt of anders schrijft.
Scroll zijwaarts op een smal scherm.
| Veld | Obsidian Tasks-emoji | Dataview-stijl | Task Genius |
|---|---|---|---|
| Deadline De uiterste datum. Obsidian Tasks leest ook 📆 en 🗓 als deadline. | 📅 2026-01-15 | [due:: 2026-01-15] | Hetzelfde als de andere twee |
| Geplande datum De dag waarop je eraan wilt werken. Obsidian Tasks leest ook ⌛. | ⏳ 2026-01-14 | [scheduled:: 2026-01-14] | Hetzelfde als de andere twee |
| Startdatum De taak is voor deze dag niet uitvoerbaar. | 🛫 2026-01-10 | [start:: 2026-01-10] | Hetzelfde als de andere twee |
| Aanmaakdatum Wordt toegevoegd als de taak wordt aangemaakt, als de plugin zo is ingesteld. | ➕ 2026-01-02 | [created:: 2026-01-02] | Hetzelfde als de andere twee |
| Voltooiingsdatum Wordt toegevoegd als je de taak afvinkt. In Dataview-stijl is de sleutel completion, niet done. | ✅ 2026-01-15 | [completion:: 2026-01-15] | Hetzelfde als de andere twee |
| Annuleringsdatum Hoort bij een status voor geannuleerd, zoals [-]. | ❌ 2026-01-15 | [cancelled:: 2026-01-15] | Hetzelfde als de andere twee |
| Prioriteit Vijf niveaus, van hoogste naar laagste. Normale prioriteit schrijf je helemaal niet. | 🔺 highest ⏫ high 🔼 medium 🔽 low ⏬ lowest | [priority:: highest] [priority:: high] [priority:: medium] [priority:: low] [priority:: lowest] | [#A] |
| Herhaling Obsidian Tasks en Dataview-stijl gebruiken gewone woorden die met every beginnen. Task Genius leest die en iCalendar-regels. Zie de sectie over herhaling. | 🔁 every week on Sunday when done | [repeat:: every week on Sunday when done] | [recurrence:: FREQ=WEEKLY;BYDAY=SU] |
| Bij voltooiing Wat er met een taak gebeurt als hij klaar is. Obsidian Tasks ondersteunt keep en delete. | 🏁 delete 🏁 keep | [onCompletion:: delete] | Hetzelfde als de andere twee |
| Taak-ID Alleen letters, cijfers, koppelteken en underscore. | 🆔 abc123 | [id:: abc123] | Hetzelfde als de andere twee |
| Hangt af van Een of meer taak-ID's, gescheiden door komma's. | ⛔ abc123,def456 | [dependsOn:: abc123,def456] | Hetzelfde als de andere twee |
| Tijdstip Obsidian Tasks heeft geen tijdveld. Task Genius leest een tijd na de datum. | Niet beschikbaar | Niet beschikbaar | 📅 2026-01-15 14:30 [due:: 2026-01-15 14:30] |
| Project en context Obsidian Tasks heeft geen project- of contextveld; gebruik daar tags. Task Genius leest deze wel. | Niet beschikbaar | Niet beschikbaar | #project/Website @phone [project:: Website] [context:: phone] |
Volgorde waarin Obsidian Tasks velden schrijft
Als Obsidian Tasks een regel schrijft, zet hij eerst het ID, de afhankelijkheden, de prioriteit, de herhaling en de actie bij voltooiing neer, dan de aanmaak-, start-, geplande en deadlinedatum, en daarna de annulerings- en voltooiingsdatum. Met de hand in een andere volgorde schrijven werkt, zolang elk veld aan het eind van de regel staat.
Statustekens
Het teken tussen de haken is de status. Alleen de spatie en de x zijn universeel. Al het andere is een afspraak waaraan een plugin, een thema of een statuscollectie betekenis geeft.
| Teken | Gebruikelijke betekenis | Wie het begrijpt |
|---|---|---|
[ ] | Te doen | Alles, ook Obsidian zelf |
[x] | Klaar (x of X) | Alles, ook Obsidian zelf |
[/] | Bezig | Task Genius standaard, Obsidian Tasks als aangepaste status |
[-] | Geannuleerd of laten vallen | Task Genius standaard, Obsidian Tasks als aangepaste status |
[>] | Bezig (Task Genius) of doorgestuurd | Task Genius standaard, elders een afspraak |
[<] | Gepland | Een afspraak uit statuscollecties en thema's, geen standaard van Task Genius; een aangepaste status in Obsidian Tasks |
[?] | In de planning | Task Genius standaard, elders vaak gelezen als vraag |
[!] | Belangrijk | Een afspraak uit statuscollecties en thema's, geen standaard van Task Genius; een aangepaste status in Obsidian Tasks |
In Obsidian Tasks verschijnt een teken dat je niet hebt ingesteld als status Unknown. Voeg het toe in de Custom Statuses-instellingen van de plugin, of laad een kant-en-klare statuscollectie.
Task Genius ziet alleen x en X als voltooid. TaskNotes-bestanden gebruiken helemaal geen selectievakjetekens; ze hebben een eigenschap status, hieronder uitgelegd.
Herhaling
Bij herhaling verschillen de formaten het meest. Dezelfde wekelijkse taak, op vier manieren geschreven:
- [ ] 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 Regels die Obsidian Tasks begrijpt
Elke regel begint met het woord every. Voeg when done toe om te tellen vanaf de dag dat je de taak afrondt in plaats van vanaf de oorspronkelijke datum.
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 Hoe voltooien zich gedraagt
- Obsidian Tasks: een terugkerende taak afvinken markeert die regel als klaar en voegt een nieuwe regel toe, standaard erboven, met de datums opgeschoven. Een instelling zet de nieuwe regel eronder.
- Obsidian Tasks: een terugkerende taak heeft minstens een deadline-, geplande of startdatum nodig. Zonder datum heeft de regel niets om te verschuiven.
- Obsidian Tasks: bij een maandelijkse regel schuift een datum die niet bestaat (de 31e in april) terug naar de laatste geldige dag. Een regel die de 31e noemt, slaat juist maanden zonder 31e over.
- Obsidian Tasks: de nieuwe regel laat ID en afhankelijkheidsveld vallen, zodat een afhankelijkheid niet eeuwig blokkeert.
- TaskNotes: het bestand blijft één taak. Voltooide en overgeslagen datums komen in complete_instances en skipped_instances, en het schema schuift op.
- Task Genius: de volgende datum komt uit een iCalendar-regel of een eenvoudige zin zoals every 2 weeks. Rijkere Obsidian Tasks-zinnen, zoals every weekday of the last Friday of the month, worden niet op dezelfde manier gelezen, dus test er een paar voordat je erop vertrouwt.
- Houd terugkerende taken uit dagelijkse notities. Een terugkerende regel in een dagelijkse notitie wordt naar de notitie van elke dag gekopieerd.
Taakbestanden: TaskNotes-frontmatter
TaskNotes bewaart één taak per notitie. De gegevens staan in YAML-frontmatter en de tekst is vrij. Een bestand telt als taak als het de tag of eigenschap heeft die je in de plugininstellingen hebt gekozen, standaard de 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. Eigenschappen
| Eigenschap | Voorbeeld | Betekenis |
|---|---|---|
| title | | De naam van de taak. |
| status | | Een waarde uit je statuslijst. Standaard zijn dat open, in-progress en done. |
| priority | | Een waarde uit je prioriteitenlijst. Standaard zijn dat low, normal en high. |
| due | | Deadline, als datum of als datum en tijd. |
| scheduled | | De dag waarop je eraan wilt werken. |
| completedDate | | Wordt gezet als de taak is voltooid. |
| dateCreated | | Aanmaaktijd als ISO-tijdstempel. |
| dateModified | | Laatste wijziging als ISO-tijdstempel. |
| tags | | Een YAML-lijst, geschreven zonder het hekje. |
| contexts | | Een YAML-lijst met plaatsen of modi. |
| projects | | Een YAML-lijst met links naar projectnotities. |
| timeEstimate | | Een aantal minuten. |
| recurrence | | Een iCalendar-regel. DTSTART bepaalt de ankerdatum. |
| recurrence_anchor | | scheduled of completion: waarvan de volgende datum wordt geteld. |
| complete_instances | | Datums van afgeronde keren van een terugkerende taak. |
| skipped_instances | | Datums van overgeslagen keren. |
| blockedBy | | Taken die eerst klaar moeten zijn, als objecten met een uid, een relatietype en een optionele tussenruimte. |
Eigenschapsnamen zijn instellingen. Als je in de plugin due hernoemt naar deadline, moet het bestand deadline gebruiken.
Lijsten moeten lijsten zijn, ook met één item. Een losse waarde waar een lijst wordt verwacht is de meest voorkomende reden dat een taakbestand niet in een weergave verschijnt.
Valkuilen die je een avond kosten
- Obsidian Tasks leest en schrijft één formaat tegelijk. Als zijn instelling Dataview is, leest hij zijn eigen emoji niet meer tot je terugschakelt.
- Dataview heeft een dubbele dubbele punt nodig, [due:: 2026-01-15]. Een enkele dubbele punt is geen veld.
- Haken moeten bij elkaar passen. [due:: 2026-01-15) wordt niet gelezen.
- Obsidian Tasks-sleutels zijn in Dataview-stijl hoofdlettergevoelig: repeat, dependsOn en onCompletion werken, Repeat en dependson niet. Task Genius vergelijkt sleutels zonder op hoofdletters te letten.
- De sleutel voor de voltooiingsdatum is completion. [done:: 2026-01-15] is gewoon een onbekend veld.
- Dataview documenteert 🗓️ als zijn snelkoppeling voor deadline, terwijl Obsidian Tasks 📅 schrijft. Als je emoji-datums met Dataview opvraagt, test dan eerst je eigen versie. Velden tussen haken omzeilen de vraag.
- Geplakte tekst kan niet-afbrekende spaties of een variatieselector na een emoji bevatten. Obsidian Tasks leest die niet, en de regel ziet er op het scherm goed uit.
- Dataview heeft snelkoppelingen voor maar vijf datums. Prioriteit en herhaling hebben er geen en vragen om de vorm met haken.
- Een globaal filter zoals #task in Obsidian Tasks zorgt dat hij elk selectievakje zonder die tag negeert. Taken die uit zoekopdrachten verdwijnen, zijn vaak dit.
- Regels met een selectievakje binnen een omheind codeblok zijn in geen van deze plugins taken.
Bronnen van waarheid
Plugins veranderen. Als iets hier niet klopt voor jouw versie, vertrouw dan op deze bronnen in plaats van op deze pagina.
- Obsidian Tasks: Tasks Emoji Format (emojiformaat)
- Obsidian Tasks: Dataview Format
- Obsidian Tasks: Recurring Tasks (terugkerende taken)
- Obsidian Tasks: Statuses
- Dataview: Metadata on Tasks and Lists
- Dataview: Adding Metadata (inline fields)
- Task Genius-documentatie
- Task Genius op GitHub
- TaskNotes-documentatie
- TaskNotes: Referentie voor eigenschapstypen
Gebruiken op een telefoon
TaskForge, een aparte app voor iPhone, iPad, Mac, Android en Windows, leest de emoji-, Dataview- en Task Genius-vormen hierboven en taakbestanden in TaskNotes-stijl uit dezelfde map. Het is geen Obsidian-plugin en heeft geen band met Obsidian. Je hebt het niet nodig om iets op deze pagina te gebruiken.
Veelgestelde vragen
Wat is de Obsidian Tasks-syntax voor een deadline?
Typ de kalenderemoji, een spatie en de datum: - [ ] Pay rent 📅 2026-01-15. In Dataview-stijl is het [due:: 2026-01-15]. Beide gebruiken YYYY-MM-DD.
Wat zijn de prioriteitsemoji van Obsidian Tasks?
🔺 hoogste, ⏫ hoog, 🔼 gemiddeld, 🔽 laag en ⏬ laagste. Normale prioriteit heeft geen symbool. In Dataview-stijl is het veld priority en zijn de waarden highest, high, medium, low en lowest.
Kan ik Dataview inline velden gebruiken in plaats van emoji voor Obsidian Tasks?
Ja. Zet het taakformaat in de instellingen van Obsidian Tasks op Dataview en hij leest en schrijft velden in de stijl [due:: 2026-01-15]. Hij leest alleen het formaat dat je kiest, dus bestaande emoji-regels moeten worden geconverteerd. Zie de conversiepagina voor recepten.
Hoe schrijf ik een terugkerende taak in Obsidian?
Voeg bij Obsidian Tasks 🔁 toe met een regel die met every begint, plus minstens één datum: - [ ] Water plants 🔁 every week on Sunday 📅 2026-01-18. Zet bij TaskNotes de eigenschap recurrence op een iCalendar-regel zoals FREQ=WEEKLY;BYDAY=SU.
Welke statustekens kan een Obsidian-taak hebben?
Elk los teken past tussen de haken. De spatie en de x zijn standaard. Tekens zoals /, - en > betekenen pas iets als een plugin of thema ze definieert.
Gebruikt Task Genius dezelfde syntax als Obsidian Tasks?
Hij leest dezelfde emoji en de Dataview-vorm met haken op één regel, dus een kluis die voor Obsidian Tasks is geschreven werkt. Hij voegt een tijd na de datum toe, project- en contextvelden en iCalendar-herhalingsregels. Welk formaat hij schrijft is een instelling.