Vai al contenuto principale
TaskForge 3.0: l'IA legge le tue attività.

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:

Emoji di Obsidian Tasks
- [ ] Pay rent ⏫ 🔁 every month ➕ 2026-01-02 ⏳ 2026-01-14 📅 2026-01-15
Campi inline di Dataview
- [ ] Pay rent  [priority:: high]  [repeat:: every month]  [created:: 2026-01-02]  [scheduled:: 2026-01-14]  [due:: 2026-01-15]
Task Genius (emoji e parentesi possono stare nella stessa riga)
- [ ] Pay rent #project/Home @bank ⏫ 📅 2026-01-15 09:00 [repeat:: every month]
TaskNotes (un intero file invece di una riga)

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:

Emoji di Obsidian Tasks
- [ ] Water plants 🔁 every week on Sunday when done 📅 2026-01-18
Stile Dataview
- [ ] Water plants  [repeat:: every week on Sunday when done]  [due:: 2026-01-18]
Task Genius
- [ ] Water plants [recurrence:: FREQ=WEEKLY;BYDAY=SU] [due:: 2026-01-18]
File TaskNotes
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.

Un file di attività TaskNotes
---
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
title: Review quarterly report
Il nome dell’attività.
status
status: in-progress
Un valore dalla tua lista di stati. Quelli predefiniti sono open, in-progress e done.
priority
priority: high
Un valore dalla tua lista di priorità. Quelli predefiniti sono low, normal e high.
due
due: 2026-01-15
Scadenza, come data oppure data e ora.
scheduled
scheduled: 2026-01-14T09:00
Il giorno in cui prevedi di lavorarci.
completedDate
completedDate: 2026-01-15
Impostata quando l’attività viene completata.
dateCreated
dateCreated: 2026-01-02T08:00:00Z
Ora di creazione come timestamp ISO.
dateModified
dateModified: 2026-01-15T10:30:00Z
Ultima modifica come timestamp ISO.
tags
tags: [task, finance]
Una lista YAML, scritta senza cancelletto.
contexts
contexts: [office]
Una lista YAML di luoghi o modalità.
projects
projects: ["[[Q1 Planning]]"]
Una lista YAML di link a note di progetto.
timeEstimate
timeEstimate: 90
Un numero di minuti.
recurrence
recurrence: "FREQ=WEEKLY;BYDAY=MO,WE,FR"
Una regola iCalendar. DTSTART imposta la data di ancoraggio.
recurrence_anchor
recurrence_anchor: completion
scheduled o completion: da dove si conta la data successiva.
complete_instances
complete_instances: ["2026-01-08"]
Date delle occorrenze completate di un’attività ricorrente.
skipped_instances
skipped_instances: ["2026-01-22"]
Date delle occorrenze saltate.
blockedBy
- uid: "Tasks/Draft report.md"
  reltype: FINISHTOSTART
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.

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.