Vai al contenuto principale
Integrazione

Guida all'Integrazione TaskNotes: Un'Attività per File con Frontmatter YAML

Scopri come TaskForge supporta il formato TaskNotes per Obsidian, permettendoti di gestire le attività con un'attività per file usando il frontmatter YAML. Perfetto per documentazione dettagliata delle attività, metadati ricchi e workflow di presa appunti strutturata.

Integrazione TaskNotes di TaskForge su macOS che mostra un'attività per file con frontmatter YAML
Visualizza Tutte le Funzionalità

Cos'è il Formato TaskNotes?

TaskNotes è un formato di gestione attività che memorizza un'attività per file usando il frontmatter YAML per i metadati. A differenza delle attività inline sparse nelle tue note, TaskNotes dà a ogni attività il suo file dedicato con proprietà strutturate e molto spazio per documentazione dettagliata.

Un'Attività per File

Ogni attività vive nel suo file markdown, dandoti spazio illimitato per note, allegati e documentazione.

Frontmatter YAML

Memorizza i metadati delle attività in frontmatter YAML strutturato per stato, priorità, date, tag e proprietà personalizzate.

Identificazione Flessibile

Identifica i TaskNotes per tag o proprietà personalizzata. Scegli il metodo che si adatta meglio al tuo workflow.

Cartelle Configurabili

Imposta una cartella predefinita per i nuovi TaskNotes e organizzali come funziona meglio per la struttura del tuo vault.

Esempio di File TaskNotes

Ecco come appare un tipico file TaskNotes nel tuo vault Obsidian:

---
status: in-progress
priority: high
due: 2025-10-15
tags:
  - work
  - project-alpha
created: 2025-10-01
---

# Review PR #123

Review the new authentication system PR and provide feedback on:

- [ ] Code quality and patterns
- [ ] Test coverage
- [ ] Documentation completeness
- [ ] Security considerations

## Notes

- Need to verify the new token refresh logic
- Check that rate limiting is properly implemented
- Test with various user permission levels

## Links

- [[Authentication Design Doc]]
- [[Security Guidelines]]

Proprietà Supportate

Stato

Stato di completamento attività: da-fare, in-corso, in-attesa, pianificato o completato

status: in-progress

Priorità

Importanza dell'attività: massima, alta, media, bassa o minima

priority: high

Date

Date di scadenza, date programmate, date di inizio e date di completamento

due: 2025-10-15 scheduled: 2025-10-10 start: 2025-10-01

Tag

Organizza le attività con più tag in formato lista

tags:
  - work
  - urgent
  - project-alpha

Ricorrenza

Imposta attività ricorrenti con intervalli flessibili

recurrence: every week

Configurare TaskNotes

  1. 1

    Enable File Attività

    Open Impostazioni > Tipi di Attività, toggle 'File Attività' on, then tap 'Impostazioni File Attività' to configure identification, default folder, and field mapping.

  2. 2

    Scegli il Metodo di Identificazione

    Seleziona come TaskForge dovrebbe identificare i file TaskNotes: per un tag specifico (es. #attività) o per una proprietà personalizzata (es. tipo: attività).

  3. 3

    Imposta la Cartella Predefinita

    Scegli una cartella predefinita dove dovrebbero essere creati i nuovi TaskNotes. Questo aiuta a mantenere il tuo vault organizzato.

  4. 4

    Scegli il Formato Predefinito

    Decidi se le nuove attività dovrebbero essere create come TaskNotes o attività inline per impostazione predefinita. Puoi sempre sovrascrivere questo per lista personalizzata.

  5. 5

    Personalizza la Mappatura Campi (Opzionale)

    Avanzato: Personalizza i nomi delle proprietà YAML se usi nomi di campo diversi nel tuo vault.

TaskNotes vs. Attività Inline

Usa TaskNotes Quando:

  • Hai bisogno di documentazione dettagliata delle attività
  • Le attività richiedono più note e allegati
  • Preferisci metadati strutturati
  • Le attività sono progetti complessi
  • Vuoi archivi attività ricercabili

Usa Attività Inline Quando:

  • Le attività sono semplici elementi d'azione
  • Le attività appartengono a note di riunione
  • Preferisci attività incorporate nel contesto
  • La cattura rapida è prioritària
  • Usi il plugin Obsidian Tasks

Buone notizie: Non devi scegliere! TaskForge supporta entrambi i formati fianco a fianco. Usa TaskNotes per grandi progetti e attività inline per elementi d'azione rapidi - tutto in una lista attività unificata.

Quali funzionalita avanzate di TaskNotes sono disponibili?

Oltre alle basi della gestione di un'attivita per file, TaskNotes offre diverse funzionalita avanzate che ti permettono di personalizzare il sistema per il tuo flusso di lavoro esatto. Queste opzioni sono particolarmente utili se hai gia una struttura di vault consolidata o convenzioni specifiche per organizzare le tue note.

Mappatura campi personalizzata

Se il tuo vault usa gia nomi di proprieta YAML diversi, non hai bisogno di cambiarli. TaskForge ti permette di rimappare i nomi dei campi predefiniti per farli corrispondere ai tuoi. Ad esempio, se usi 'state' invece di 'status' o 'importance' invece di 'priority', puoi configurare TaskForge per leggere e scrivere quei campi direttamente. Questo significa che puoi adottare TaskNotes senza ristrutturare un singolo file esistente.

Formati personalizzati per i nomi dei file

Controlla esattamente come vengono nominati i nuovi file TaskNotes usando variabili come {title}, {date} e {priority}. Ad esempio, potresti impostare il formato come '{date}-{title}' in modo che ogni file di attivita inizi con la sua data di creazione, rendendo facile ordinare i file cronologicamente nell'esploratore file di Obsidian.

Template del corpo

Definisci un template di corpo markdown predefinito che viene inserito in ogni nuovo file TaskNotes. Se vuoi sempre una sezione Note, una sezione Checklist e una sezione Link nei tuoi file di attivita, configura un template una volta e ogni nuova attivita iniziera con quella struttura. I template ti risparmiano di digitare lo stesso contenuto ripetitivo piu e piu volte.

Progetti e contesti

TaskNotes supporta annotazioni di progetto e contesto usando la sintassi +NomeProgetto e @contesto. Tagga un'attivita con +RestylingWebsite per legarla a un progetto specifico, o @ufficio per indicare dove il lavoro dovrebbe avvenire. Queste annotazioni funzionano insieme ai tag regolari, offrendoti un modo piu ricco di categorizzare e filtrare le attivita nel tuo vault.

Come migrare dalle attivita inline a TaskNotes?

Se hai usato attivita inline e vuoi iniziare a sfruttare TaskNotes, la buona notizia e che non devi cambiare tutto in una volta. TaskForge supporta entrambi i formati simultaneamente, quindi puoi migrare gradualmente al tuo ritmo.

1

Inizia con le attivita complesse

I migliori candidati per la migrazione sono le attivita che sono cresciute oltre una singola riga. Se ti ritrovi ad aggiungere lunghe descrizioni, piu sotto-attivita o link di riferimento a un'attivita inline, quell'attivita e un candidato naturale per il formato TaskNotes dove ottiene il suo file e spazio illimitato per la documentazione.

2

Mantieni le attivita semplici inline

Non tutte le attivita hanno bisogno del proprio file. Azioni rapide come 'Comprare la spesa' o 'Rispondere all'email di Sara' funzionano perfettamente come attivita inline. Riserva il formato TaskNotes per attivita che beneficiano genuinamente di metadati strutturati e note dettagliate.

3

Usa entrambi i formati simultaneamente

TaskForge mostra attivita inline e TaskNotes insieme nella stessa lista attivita unificata. Non devi preoccuparti di mescolare formati - entrambi i tipi appaiono nelle tue liste personalizzate, viste calendario e widget. L'app gestisce la differenza dietro le quinte cosi puoi concentrarti sul tuo lavoro.

4

Organizza TaskNotes in una cartella dedicata

Crea una cartella dedicata nel tuo vault per i file TaskNotes, come 'Tasks' o 'TaskNotes'. Questo mantiene il tuo vault ordinato e rende facile trovare i file delle attivita nell'esploratore file di Obsidian. Imposta questa cartella come posizione predefinita nelle impostazioni di TaskForge cosi ogni nuovo file TaskNotes finisce automaticamente nel posto giusto.

5

Migra in lotti

Invece di convertire tutte le tue attivita inline in una volta, scegli un progetto o un'area della tua vita da migrare prima. Sposta le tue attivita lavorative su TaskNotes per una settimana e vedi come ti trovi. Una volta che ti senti a tuo agio con il flusso di lavoro, espanditi ad altre aree. Questo approccio graduale ti permette di perfezionare la mappatura dei campi e i template prima di impegnarti completamente.

Pronto a Provare TaskNotes?

Scarica TaskForge e inizia a usare il formato TaskNotes per i tuoi workflow di gestione attività dettagliati in Obsidian. Scopri tutte le funzionalità TaskNotes sulla nostra pagina delle funzionalità , e dai un'occhiata agli ultimi miglioramenti TaskNotes per gli aggiornamenti recenti.

Azhar Dewji
Azhar Dewji · · Updated July 8, 2026

Ingegnere del software con oltre 10 anni di esperienza nello sviluppo di app mobile e desktop in Swift, Kotlin e Flutter. Sviluppatore indipendente con base a Toronto, Canada. Creatore di TaskForge. Scopri di più