Guida rapida ai formati delle attività Obsidian
Obsidian non ha una sintassi per le attività oltre alla checkbox. Il resto lo aggiungono i plugin, e lo fanno in quattro modi diversi. Questa pagina elenca ogni campo in ciascun modo, con i caratteri esatti da digitare.
Verificato a ottobre 2026 su Obsidian Tasks 8.6, Task Genius 9.13, TaskNotes 4.14 e sulla documentazione di Dataview. La documentazione di ogni plugin è linkata in fondo e prevale se non concorda con questa pagina.
Stampando questa pagina ottieni un riferimento compatto, senza la navigazione del sito.
Anatomia di una riga di attività
Un’attività è un elemento di elenco con una checkbox. Dopo la descrizione vengono i campi, ciascuno un simbolo seguito da un valore. Obsidian Tasks legge la riga da destra: i campi vanno quindi alla fine, dopo il testo, e qualsiasi testo non riconosciuto tra due campi interrompe la lettura in quel punto.
La stessa attività in ciascun formato inline:
- [ ] 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 file di attività conserva gli stessi dati nel frontmatter YAML. Vedi la sezione sui file di attività più sotto.
I campi, affiancati
Le date sono sempre YYYY-MM-DD. La colonna Dataview usa le parentesi quadre. Obsidian Tasks e Dataview leggono anche le parentesi tonde, (due:: 2026-01-15); Task Genius legge solo le parentesi quadre. Task Genius legge l’emoji e la forma con le parentesi, quindi la sua colonna elenca solo ciò che aggiunge o scrive in modo diverso.
Scorri in orizzontale su uno schermo stretto.
| Campo | Emoji di Obsidian Tasks | Stile Dataview | Task Genius |
|---|---|---|---|
| Data di scadenza Il termine ultimo. Obsidian Tasks legge come scadenza anche 📆 e 🗓. | 📅 2026-01-15 | [due:: 2026-01-15] | Uguale agli altri due |
| Data programmata Il giorno in cui prevedi di lavorarci. Obsidian Tasks legge anche ⌛. | ⏳ 2026-01-14 | [scheduled:: 2026-01-14] | Uguale agli altri due |
| Data di inizio L’attività non è lavorabile prima di questo giorno. | 🛫 2026-01-10 | [start:: 2026-01-10] | Uguale agli altri due |
| Data di creazione Aggiunta quando l’attività viene creata, se il plugin è impostato per farlo. | ➕ 2026-01-02 | [created:: 2026-01-02] | Uguale agli altri due |
| Data di completamento Aggiunta quando spunti l’attività. Nello stile Dataview la chiave è completion, non done. | ✅ 2026-01-15 | [completion:: 2026-01-15] | Uguale agli altri due |
| Data di annullamento Si abbina a uno stato annullato come [-]. | ❌ 2026-01-15 | [cancelled:: 2026-01-15] | Uguale agli altri due |
| Priorità Cinque livelli, dal più alto al più basso. La priorità normale non si scrive affatto. | 🔺 highest ⏫ high 🔼 medium 🔽 low ⏬ lowest | [priority:: highest] [priority:: high] [priority:: medium] [priority:: low] [priority:: lowest] | [#A] |
| Ricorrenza Obsidian Tasks e lo stile Dataview usano parole semplici che iniziano con every. Task Genius legge queste e le regole iCalendar. Vedi la sezione sulla ricorrenza. | 🔁 every week on Sunday when done | [repeat:: every week on Sunday when done] | [recurrence:: FREQ=WEEKLY;BYDAY=SU] |
| Al completamento Cosa fare di un’attività quando è completata. Obsidian Tasks supporta keep e delete. | 🏁 delete 🏁 keep | [onCompletion:: delete] | Uguale agli altri due |
| ID dell’attività Solo lettere, cifre, trattino e trattino basso. | 🆔 abc123 | [id:: abc123] | Uguale agli altri due |
| Dipende da Uno o più ID di attività, separati da virgole. | ⛔ abc123,def456 | [dependsOn:: abc123,def456] | Uguale agli altri due |
| Ora del giorno Obsidian Tasks non ha un campo per l’ora. Task Genius legge un’ora dopo la data. | Non disponibile | Non disponibile | 📅 2026-01-15 14:30 [due:: 2026-01-15 14:30] |
| Progetto e contesto Obsidian Tasks non ha un campo progetto o contesto; lì usa i tag. Task Genius legge questi campi. | Non disponibile | Non disponibile | #project/Website @phone [project:: Website] [context:: phone] |
Ordine in cui Obsidian Tasks scrive i campi
Quando Obsidian Tasks scrive una riga, mette prima l’ID, le dipendenze, la priorità, la ricorrenza e l’azione al completamento, poi le date di creazione, inizio, programmata e scadenza, infine quelle di annullamento e completamento. Scrivere a mano in un altro ordine funziona finché ogni campo sta alla fine della riga.
Caratteri di stato
Il carattere dentro le parentesi è lo stato. Solo lo spazio e la x sono universali. Tutto il resto è una convenzione a cui un plugin, un tema o una raccolta di stati dà significato.
| Carattere | Significato abituale | Chi lo capisce |
|---|---|---|
[ ] | Da fare | Tutto, compreso Obsidian stesso |
[x] | Completata (x o X) | Tutto, compreso Obsidian stesso |
[/] | In corso | Task Genius per impostazione predefinita, Obsidian Tasks come stato personalizzato |
[-] | Annullata o abbandonata | Task Genius per impostazione predefinita, Obsidian Tasks come stato personalizzato |
[>] | In corso (Task Genius) o inoltrata | Task Genius per impostazione predefinita, una convenzione altrove |
[<] | Programmata | Una convenzione di raccolte di stati e temi, non un’impostazione predefinita di Task Genius; uno stato personalizzato in Obsidian Tasks |
[?] | Pianificata | Task Genius per impostazione predefinita, spesso letto come domanda altrove |
[!] | Importante | Una convenzione di raccolte di stati e temi, non un’impostazione predefinita di Task Genius; uno stato personalizzato in Obsidian Tasks |
In Obsidian Tasks, un carattere che non hai configurato compare come stato sconosciuto (Unknown). Aggiungilo nelle impostazioni Custom Statuses del plugin, oppure carica una raccolta di stati già pronta.
Task Genius considera completate solo x e X. I file TaskNotes non usano affatto i caratteri della checkbox; hanno una proprietà status, trattata più sotto.
Ricorrenza
La ricorrenza è il punto in cui i formati differiscono di più. La stessa attività settimanale, scritta in quattro modi:
- [ ] 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 Regole che Obsidian Tasks capisce
Ogni regola inizia con la parola every. Aggiungi when done per contare dal giorno in cui finisci invece che dalla data originale.
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 Come si comporta il completamento
- Obsidian Tasks: spuntare un’attività ricorrente segna quella riga come completata e aggiunge una nuova riga, per impostazione predefinita sopra, con le date spostate in avanti. Un’impostazione mette invece la nuova riga sotto.
- Obsidian Tasks: un’attività ricorrente ha bisogno di almeno una data tra scadenza, programmata e inizio. Senza, la regola non ha nulla da spostare.
- Obsidian Tasks: con una regola mensile, una data che non esiste (il 31 ad aprile) slitta indietro all’ultimo giorno valido. Una regola che indica esplicitamente il 31 salta invece i mesi che non lo hanno.
- Obsidian Tasks: la nuova riga scarta qualsiasi ID e il campo depends-on, così una dipendenza non blocca per sempre.
- TaskNotes: il file resta un’unica attività. Le date completate e saltate vanno in complete_instances e skipped_instances, e la pianificazione avanza.
- Task Genius: la data successiva deriva da una regola iCalendar o da una frase semplice come every 2 weeks. Le frasi più ricche di Obsidian Tasks, come every weekday o the last Friday of the month, non sono lette allo stesso modo, quindi provane alcune prima di farci affidamento.
- Tieni le attività ricorrenti fuori dalle note giornaliere. Una riga ricorrente in una nota giornaliera viene copiata nella nota di ogni giorno.
File di attività: frontmatter di TaskNotes
TaskNotes salva un’attività per nota. I dati stanno nel frontmatter YAML e il corpo è testo libero. Un file conta come attività se ha il tag o la proprietà che imposti nelle impostazioni del plugin, per impostazione predefinita il 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. Proprietà
| Proprietà | Esempio | Significato |
|---|---|---|
| title | | Il nome dell’attività. |
| status | | Un valore dalla tua lista di stati. Quelli predefiniti sono open, in-progress e done. |
| priority | | Un valore dalla tua lista di priorità. Quelli predefiniti sono low, normal e high. |
| due | | Scadenza, come data oppure data e ora. |
| scheduled | | Il giorno in cui prevedi di lavorarci. |
| completedDate | | Impostata quando l’attività viene completata. |
| dateCreated | | Ora di creazione come timestamp ISO. |
| dateModified | | Ultima modifica come timestamp ISO. |
| tags | | Una lista YAML, scritta senza cancelletto. |
| contexts | | Una lista YAML di luoghi o modalità. |
| projects | | Una lista YAML di link a note di progetto. |
| timeEstimate | | Un numero di minuti. |
| recurrence | | Una regola iCalendar. DTSTART imposta la data di ancoraggio. |
| recurrence_anchor | | scheduled o completion: da dove si conta la data successiva. |
| complete_instances | | Date delle occorrenze completate di un’attività ricorrente. |
| skipped_instances | | Date delle occorrenze saltate. |
| blockedBy | | Attività che devono finire prima, come oggetti con un uid, un tipo di relazione e un intervallo facoltativo. |
I nomi delle proprietà sono impostazioni. Se nel plugin rinomini due in deadline, il file deve usare deadline.
Le liste devono essere liste, anche con un solo elemento. Uno scalare dove è attesa una lista è il motivo più comune per cui un file di attività non compare in una vista.
Trabocchetti che costano una serata
- Obsidian Tasks legge e scrive un solo formato alla volta. Se la sua impostazione è Dataview, le sue stesse emoji non vengono più lette finché non torni indietro.
- Dataview vuole il doppio due punti, [due:: 2026-01-15]. Un singolo due punti non è un campo.
- Le parentesi devono corrispondere. [due:: 2026-01-15) non viene letto.
- Le chiavi di Obsidian Tasks distinguono maiuscole e minuscole nello stile Dataview: repeat, dependsOn e onCompletion funzionano, Repeat e dependson no. Task Genius confronta le chiavi senza badare alle maiuscole.
- La chiave della data di completamento è completion. [done:: 2026-01-15] è solo un campo sconosciuto.
- Dataview documenta 🗓️ come scorciatoia per la scadenza, mentre Obsidian Tasks scrive 📅. Se interroghi date in emoji con Dataview, prova prima la tua versione. I campi tra parentesi evitano il problema.
- Il testo incollato può portare spazi non separabili o un selettore di variante dopo un’emoji. Obsidian Tasks non li legge, e la riga sullo schermo sembra a posto.
- Dataview ha scorciatoie solo per cinque date. Priorità e ricorrenza non ne hanno e richiedono la forma con le parentesi.
- Un filtro globale come #task in Obsidian Tasks gli fa ignorare ogni checkbox senza quel tag. Le attività che spariscono dalle query dipendono spesso da questo.
- Le righe con checkbox dentro un blocco di codice recintato non sono attività in nessuno di questi plugin.
Fonti di riferimento
I plugin cambiano. Quando qualcosa qui sembra sbagliato per la tua versione, fidati di queste fonti piuttosto che di questa pagina.
- Obsidian Tasks: formato emoji di Tasks (Tasks Emoji Format)
- Obsidian Tasks: Dataview Format
- Obsidian Tasks: attività ricorrenti (Recurring Tasks)
- Obsidian Tasks: Statuses
- Dataview: Metadata on Tasks and Lists
- Dataview: Adding Metadata (inline fields)
- Documentazione di Task Genius
- Task Genius su GitHub
- Documentazione di TaskNotes
- TaskNotes: Property Types Reference
Usarli su un telefono
TaskForge, un’app separata per iPhone, iPad, Mac, Android e Windows, legge le forme emoji, Dataview e Task Genius qui sopra e i file di attività in stile TaskNotes dalla stessa cartella. Non è un plugin di Obsidian e non ha alcun legame con Obsidian. Non ti serve per usare nulla di ciò che trovi in questa pagina.
Domande frequenti
Qual è la sintassi di Obsidian Tasks per una data di scadenza?
Digita l’emoji del calendario, uno spazio e la data: - [ ] Pay rent 📅 2026-01-15. Nello stile Dataview è [due:: 2026-01-15]. Entrambi usano YYYY-MM-DD.
Quali sono le emoji di priorità di Obsidian Tasks?
🔺 massima, ⏫ alta, 🔼 media, 🔽 bassa e ⏬ minima. La priorità normale non ha simbolo. Nello stile Dataview il campo è priority e i valori sono highest, high, medium, low e lowest.
Posso usare i campi inline di Dataview al posto delle emoji in Obsidian Tasks?
Sì. Imposta il formato delle attività nelle impostazioni di Obsidian Tasks su Dataview e leggerà e scriverà campi nello stile [due:: 2026-01-15]. Legge solo il formato che scegli, quindi le righe in emoji esistenti vanno convertite. Vedi la pagina sulla conversione per le ricette.
Come scrivo un’attività ricorrente in Obsidian?
Con Obsidian Tasks, aggiungi 🔁 e una regola che inizia con every, più almeno una data: - [ ] Water plants 🔁 every week on Sunday 📅 2026-01-18. Con TaskNotes, imposta la proprietà recurrence su una regola iCalendar come FREQ=WEEKLY;BYDAY=SU.
Quali caratteri di stato può avere un’attività Obsidian?
Qualsiasi carattere singolo sta tra le parentesi. Lo spazio e la x sono standard. Caratteri come /, - e > significano qualcosa solo quando un plugin o un tema li definisce.
Task Genius usa la stessa sintassi di Obsidian Tasks?
Legge le stesse emoji e la forma con parentesi di Dataview nella stessa riga, quindi un vault scritto per Obsidian Tasks funziona. Aggiunge un’ora dopo la data, campi progetto e contesto e regole di ricorrenza iCalendar. Quale formato scrive è un’impostazione.