La guida

Tutto quello che fa l'app, nell'ordine in cui è probabile che tu lo incontri. Descrive l'app com'è oggi: dove qualcosa manca di proposito, lo dice invece di lasciarti a cercarla.

Vault: dove stanno le tue note

Un vault è una cartella nel tuo archivio: Google Drive, OneDrive, o una cartella in un canale Teams su un account di lavoro. Pergalino legge e scrive i file che ci sono dentro e non tiene niente di suo da nessun'altra parte. Cancella l'app dalla tua vita e la cartella è esattamente quello che era: file .md, immagini, PDF.

Per aggiungerne uno: Impostazioni → Vault, oppure dalla barra laterale quando non ce n'è nessuno aperto. Google Drive apre il selettore di Google; OneDrive apre un esploratore di cartelle. Si possono tenere aperti più vault contemporaneamente, da entrambi i servizi, e compaiono come alberi separati in un'unica barra laterale con un unico campo di ricerca per tutti.

Ogni vault tiene le proprie impostazioni in una cartella nascosta .drivenote al suo interno: il vocabolario delle proprietà, i colori dei file, i preferiti, e quali file erano aperti. È questo che rende un vault trasportabile fra dispositivi, ed è il motivo per cui niente di un vault viene scritto in un altro. Impostazioni → Vault contiene anche Rileggi (rileggere la cartella da capo), Verifica ambito (che cosa l'app può davvero vedere) e Rimuovi dalla barra laterale, che smette di mostrare una cartella e non tocca niente nel tuo archivio.

La finestra

Due barre laterali attorno alle note. Ognuna contiene pannelli che puoi trascinare dall'una all'altra, e ogni pannello è una scheda: File, Recenti, Ricerca, Preferiti, Tutte le proprietà, Tag, Attività, Cronologia e Grafo. La disposizione viene ricordata per dispositivo. Le proprietà di una nota e le sue connessioni non sono pannelli: si aprono sopra e sotto il testo, dove sta la nota.

• Schede e riquadri. Ogni file aperto è una scheda; trascinane una sul bordo dell'editor per dividere, e un riquadro diviso può avere schede proprie. Una scheda si fissa dal suo menu contestuale o con un doppio clic, e una scheda fissata sopravvive a ogni chiusura che non la nomini.
• Restano aperti solo gli ultimi file. Dieci di default, regolabile in Impostazioni → Layout. Niente di non salvato, fissato o visibile viene mai chiuso per il limite, e il pannello Recenti è la via per tornare a ciò che lo è stato.
• Indietro e avanti percorrono la strada che hai fatto — le due frecce nell'intestazione, Mod+[ e Mod+], o la barra in basso sul telefono. Recenti risponde all'altra domanda: cosa è stato aperto ultimamente.

Scrivere

Le note sono Markdown. L'editor ha due modalità, scambiabili nella barra della nota: l'anteprima dal vivo, dove titoli, grassetto, collegamenti, tabelle, callout e righe di attività si vedono mentre scrivi e la sintassi si nasconde sulle righe dove non sei; e il Markdown, cioè il file esattamente com'è su disco, con i numeri di riga. In nessuna delle due viene inventato niente: quello che scrivi è quello che contiene il file.

• La barra di formattazione galleggia sopra una selezione e sul telefono si aggancia sopra la tastiera: grassetto, corsivo, titoli, elenchi, citazioni, codice, evidenziazione, attività e la fotocamera.
• I collegamenti si scrivono in una finestra di dialogo, con Mod+K o il pulsante ↗ della barra, precompilata con ciò in cui si trova il cursore. Un clic su un collegamento lo apre; nella vista Markdown serve Ctrl/Cmd, perché lì il testo è il sorgente che sei venuto a modificare.
• Tabelle, callout e blocchi di codice si vedono nell'anteprima dal vivo, il codice con l'evidenziazione del proprio linguaggio. Funziona anche ==evidenziato==, che non è né CommonMark né Markdown di GitHub, ma è quello che scrivono le altre app per appunti.
• Incollare da una pagina web conserva la formattazione, convertita in Markdown. Mod+Shift+V incolla testo semplice, e Impostazioni → Editor scambia quale dei due è il comportamento predefinito.
• Una nota si può bloccare contro la scrittura mettendo readonly: true nelle sue proprietà. Il salvataggio e il blocco delle proprietà restano attivi, così puoi sempre sbloccarla di nuovo: una serratura la cui chiave non funziona è una trappola, non una serratura.

Collegamenti, tag e incorporamenti

• I [[wikilink]] si completano mentre scrivi, su note e file: un foglio di calcolo o un PDF collegato si apre come una nota. Un collegamento a qualcosa che non esiste ancora viene segnalato, e il pannello delle connessioni propone di crearlo.
• Backlink e quasi-collegamenti. Sotto ogni nota: cosa punta qui, e poi i collegamenti che quasi hai fatto — link nel vuoto, menzioni non collegate mostrate con la loro frase, e note che il grafo mette lì vicino.
• I #tag sono etichette nel testo e nel blocco delle proprietà. Scrivere # completa dai tag che il vault già usa, ed è così che #Energia e #energia smettono di diventare due tag. Un clic su uno lo cerca. Il pannello Tag li elenca tutti con i conteggi, tag annidati compresi.
• Incorporamenti. ![[Nota]] mostra quella nota dentro questa; ![[Foglio]] mostra un file Google nella sua cornice; un PDF viene disegnato come pagina. Scrivi !-[[Nota]] e la scheda parte chiusa — lo stato è nel testo, quindi viaggia con la nota. Le caselle di una scheda si possono spuntare, e Modifica sulla scheda ti dà l'editor vero senza lasciare la pagina.

File, cartelle e allegati

• L'albero è la cartella. Clic destro su una riga (pressione lunga sul telefono, o il pulsante ⋯ sulla riga) per Nuova nota, Nuova cartella, Nuova bacheca, Nuova lista, Scansiona documento, Rinomina, Sposta in cartella, colore e Sposta nel cestino. La freccetta a sinistra di una cartella la apre e la chiude.
• Note di cartella. Una nota che si chiama come la sua cartella — Casa/Casa.md — è la pagina di quella cartella: un clic sulla cartella la apre, e un puntino nell'albero dice che c'è. Non viene salvato niente per farlo funzionare; il nome è tutto il meccanismo, quindi Obsidian e Drive vedono la stessa cosa.
• Colori. Colora una riga dal suo menu, oppure scrivi regole in Impostazioni → File: per nome, per percorso o per tipo di file, vince la prima che corrisponde. Le regole stanno nel vault, quindi seguono le note sugli altri tuoi dispositivi.
• Allegati. Trascina o incolla un file in una nota, oppure usa /attach. Viene caricato nel vault — in _attachments accanto alla nota di default, configurabile per vault — e il collegamento viene scritto per te. Immagini e PDF compaiono sul posto.
• Spostare e cestinare portano con sé gli allegati. «Sposta in cartella» propone di portarsi dietro i file propri della nota e riscrive i collegamenti in entrambi i casi; il cestino propone lo stesso. Un file a cui puntano due note non appartiene a nessuna delle due, quindi viene lasciato stare.
• Unire immagini in un PDF. Seleziona più immagini nell'albero, clic destro, e diventano un unico PDF nell'ordine che stabilisci tu. Gli originali restano dove sono.

Scansionare la carta

/scan in una nota, la fotocamera sulla barra di formattazione del telefono, oppure Scansiona documento su una cartella. La fotocamera trova la pagina, la contorna e scatta da sé appena il contorno sta fermo; gli angoli si possono trascinare se ha sbagliato. Più pagine diventano un unico PDF, oppure un'immagine per pagina — entrambe le cose sono offerte nella schermata di revisione, e lì le pagine si possono anche riordinare.

Il nome viene dalla carta: la prima pagina viene letta dal riconoscimento testo di Drive e il file prende il nome dalla riga che somiglia a un titolo, altrimenti dalla data. Quello che una scansione scrive nella nota è un incorporamento, così si vede la pagina invece del nome del file.

Gmail: la posta come note

Un'etichetta di Gmail può essere una via d'ingresso nel vault. Dai a una conversazione l'etichetta Pergalino e diventa una nota nella cartella di arrivo del vault; archivia la nota e l'etichetta la segue. È spenta finché non la accendi, appartiene a un vault solo e in Gmail non cancella, non invia e non archivia mai niente.

Accenderla: Impostazioni → Gmail, scegli il vault, accendi. La prima volta l'app ti chiede di consentire l'accesso a Gmail; Google mostra la sua schermata una volta, e la sincronizzazione parte appena torni. L'etichetta osservata è Pergalino, a meno che lì tu non scelga un altro nome.

• Una conversazione con l'etichetta Pergalino compare nella cartella di arrivo, quella che Impostazioni → File chiama la cartella delle note nuove. Una con Pergalino/Aree/Cucina va dritta in Aree/Cucina, e se la cartella manca viene creata. La nota contiene l'oggetto, il mittente, ogni messaggio come sezione e un link alla conversazione in Gmail; gli allegati vengono salvati nella cartella degli allegati e collegati.
• Spostare la nota sposta l'etichetta: trascinala in Aree/Cucina e la conversazione in Gmail porta Pergalino/Aree/Cucina, con le etichette superiori create perché Gmail le mostri annidate. Di nuovo nell'arrivo, ed è di nuovo semplicemente Pergalino. Non importa dove avviene lo spostamento: nell'app, su un altro dispositivo o direttamente in Drive. Se nel frattempo la conversazione ha cambiato etichetta anche in Gmail, vince Gmail.
• Le risposte si aggiungono in fondo alla nota, una volta sola ciascuna, sotto quello che ci hai scritto tu. La cronologia citata che ogni risposta si porta dietro viene tolta, perché i messaggi precedenti ci sono già.
• Cestinare la nota toglie le etichette Pergalino dalla conversazione e lascia stare la posta. Togliere l'etichetta in Gmail ferma la sincronizzazione di quella conversazione e lascia stare la nota.
• Rinominare l'etichetta nelle Impostazioni la rinomina anche in Gmail, con tutte quelle sotto, così ogni conversazione tiene la sua cartella.
• Ogni quanto si sceglie in Impostazioni → Gmail → Intervallo di sincronizzazione: ogni minuto, ogni 5 o 15 minuti, ogni ora, o solo con Sincronizza ora. Ogni passaggio compare in Impostazioni → Attività, e quelli che hanno cambiato qualcosa dicono cosa.

Proprietà

Il blocco sopra ogni nota è il suo frontmatter, mostrato come righe invece che come YAML. Drive fornisce creato e modificato; tutto il resto è tuo.

• Il vault ha un vocabolario. I nomi si dichiarano una volta in Impostazioni → Proprietà, e una nota sceglie da lì. È questo che impedisce a una nota di dire due, alla successiva Data di scadenza e a una terza deadline, senza che nessuno se ne accorga. Viene offerto, mai imposto: una nota che porta già un nome non dichiarato se lo tiene.
• Sette tipi, ognuno scelto perché è un controllo diverso e non una regola di validazione diversa: testo, numero, casella, scelta singola, scelta multipla, e due che prendono le opzioni da una cartella — una nota da Persone, oppure più d'una. Un valore che viene da una cartella è scritto come un [[collegamento]], quindi compare nei backlink e nel grafo.
• Due proprietà vengono dall'app e sono offerte in ogni vault: view, che disegna la nota come bacheca o come lista, e readonly, che ne blocca il testo. Nel selettore sono contrassegnate app, e nel momento in cui il tuo vault ne dichiara una per conto suo, è tua.
• Tutte le proprietà, nella barra laterale, elenca ogni nome che il vault usa davvero, con i conteggi, e propone di adottare quelli che nessuno ha dichiarato.

Attività

Un'attività è una riga: - [ ] Chiamare Hans. Pergalino la disegna come una scheda e ti lascia aggiungere il resto puntando, ma quello che scrive è lo stesso testo semplice che legge il plugin Tasks di Obsidian — una scadenza è 📅 2026-05-15, una priorità è una freccia, e non viene conservato niente da nessun'altra parte.

• Su una riga di attività, @ sceglie una data, ! una priorità e % uno stato; /due, /priority e /status fanno lo stesso da qualunque punto. Il campo della data capisce oggi, venerdì, fra 3 giorni, 3d, +2w, la prossima settimana, fine mese, 15.9 e un semplice 25 come giorno di questo mese.
• Invio continua l'elenco con una casella nuova, qualunque sia lo stato della riga sopra, e una nuova attività finisce dopo tutto ciò che pende sotto quella corrente. Maiusc+Invio scrive una riga di descrizione: le righe rientrate sotto un'attività sono il suo testo, che è già ciò che Markdown intende con esse.
• Gli stati sono i quattro che il dialetto conosce: da fare, fatto, [/] in corso e [-] annullato. Spuntare una casella ci timbra dentro la data di completamento esattamente come fa il selettore.
• Il pannello Attività raccoglie ogni attività di ogni vault aperto, raggruppata per scadenza, priorità, nota, sezione, tag o stato, con un campo di filtro che cerca nella descrizione e nel testo sotto. Una riga apre la nota al punto giusto; si spunta nella nota, dove stanno il salvataggio e l'unione.
• Nascondi le attività completate, nel menu della nota, ripiega quelle finite fuori dalla vista senza toccare il file.

Bacheche

Una bacheca è una nota con view: kanban nelle sue proprietà, più group: e filter:. Disegna altre note come schede in colonne. Togli le chiavi ed è di nuovo una nota.

• Le colonne sono le opzioni dichiarate di una proprietà — il vocabolario, non i valori che capita esistano — con una colonna per le note che non hanno valore e una per i valori che nessuno ha dichiarato. group: folder raggruppa invece per la cartella in cui sta ogni nota, e lì un rilascio sposta il file.
• Il filtro è il linguaggio di ricerca, lo stesso che parla il campo di ricerca. Creata dal menu contestuale di una cartella, una bacheca parte filtrata su quella cartella.
• Le schede possono portare proprietà e un'anteprima — cardProperties: [due, owner] e cardPreview: none|small|medium|large. Le schede sono in ordine di nome; una bacheca è una vista su note che appartengono all'archiviazione di qualcun altro, quindi non c'è un ordinamento manuale da conservare.
• Un rilascio scrive la nota della scheda stessa. Rilegge prima la nota, rifiuta quella aperta con modifiche non salvate, e reindicizza dopo.

Liste e liste della spesa

view: checklist disegna le stesse righe - [ ] come una lista fitta invece che come schede di attività: niente scadenze, niente pulsanti di priorità, gli articoli comprati sbiaditi e barrati. Nuova lista su una cartella la scrive per te.

• Scrivere un articolo propone quelli che hai già usato, i più frequenti per primi, senza quelli già sulla lista. Il vocabolario è tenuto nel vault e non nella nota, così la lista della settimana prossima parte sapendo tutto e quella della settimana scorsa si può buttare.
• Si riempie da sola. Salvare una lista ne aggiunge gli articoli; spuntarne uno lo conta, ed è questo che ordina le proposte. Due modi di scrivere la stessa cosa vengono uniti, quantità iniziale compresa: 2 latte e latte sono un solo articolo.
• Impostazioni → Liste mostra tutto il vocabolario per vault con i suoi conteggi, e rimuove un articolo che non deve più essere proposto. Lì non si può aggiungere niente: un articolo si guadagna il posto venendo scritto su una lista.
• Una seconda lista tiene le sue parole. Aggiungi list: packing accanto alla vista e quella nota attinge al proprio vocabolario, così un passaporto non viene mai proposto al supermercato.
• Gli articoli delle liste restano fuori dal pannello Attività. «Latte» non è un'attività aperta nel senso in cui quel pannello sta chiedendo.

Trovare le cose

• La ricerca copre titolo, percorso, corpo e tag di ogni nota in ogni vault aperto, e l'ultima parola che scrivi corrisponde per prefisso. Un clic su un risultato salta alla riga e la fa lampeggiare.
• Il linguaggio di ricerca: "una frase esatta", tag:casa (tag annidati compresi), path:Progetti/, property:status per le note che ne hanno una in generale, property:status=draft per un valore, prop: come forma breve, e -esclusione per lasciare fuori dei risultati.
• La palette dei comandi è Mod+Shift+P — oppure una trascinata verso il basso dall'alto dello schermo sul telefono. C'è dentro tutto quello che l'app sa fare, con la sua scorciatoia accanto. Mod+P è la domanda più corta: aprire un file per nome.
• Il grafo disegna tutto il vault, in un pannello laterale o in mezzo alla finestra. Si assesta e poi si ferma, così un grafo lasciato aperto non tiene caldo un telefono.
• I preferiti sono file con una stella, tenuti nel vault, quindi ti seguono fra i dispositivi.

Salvataggio, sincronizzazione e cronologia

• Si salva con Mod+S, oppure automaticamente poco dopo che smetti di scrivere se attivi il salvataggio automatico in Impostazioni → Editor. Una scheda con lavoro non salvato mostra un puntino e non si può chiudere per sbaglio.
• Le modifiche dagli altri tuoi dispositivi arrivano da sole. Una nota pulita si ricarica; una nota che stai modificando viene unita, e solo una vera sovrapposizione si ferma a chiedere — Vedi entrambe, Tieni la mia, o Prendi la loro. Niente sovrascrive una bozza di propria iniziativa.
• La cronologia delle versioni, nella barra laterale destra, elenca le revisioni del file così come le conserva il tuo archivio, mostra un confronto e ne ripristina una. È la cronologia del fornitore, non una copia che quest'app tiene.
• Offline, un vault già letto resta leggibile e ricercabile, e l'app stessa parte dalla sua cache. Le scritture aspettano la rete.
• Quello che l'app sta facendo è nella barra di stato, e sul telefono nella barra della nota finché dura. Impostazioni → Attività elenca tutto quello che sta girando adesso, quello che è girato da quando la scheda è stata aperta, e ogni esecuzione che ha cambiato qualcosa o è fallita.

Sul telefono

Aggiungi il sito alla schermata Home e si comporta come un'app: parte dalla propria cache, ha il proprio archivio, e non ha la cornice del browser. Il layout cambia con lo schermo invece che con la larghezza della finestra, e Impostazioni → Layout può scavalcarlo.

• Con una nota aperta c'è una barra fluttuante a ciascuna estremità invece dell'intestazione, della barra della nota e della barra di stato. Entrambe si tirano da parte mentre scorri verso il basso e tornano a qualsiasi movimento verso l'alto — e restano ferme finché l'app sta lavorando, così una lunga lettura di un vault non è mai invisibile.
• I pannelli laterali sono cassetti sopra la nota; li aprono i due pulsanti nella barra della nota. Un documento alla volta, quindi non c'è una barra delle schede: il numero nella barra in basso apre l'elenco di quello che è aperto, con i segni del non salvato.
• La pressione lunga è il clic destro, e ogni riga porta anche un pulsante ⋯. I menu si aprono come foglio dal fondo dello schermo.

Impostazioni

Due ambiti, e la differenza è voluta. Le impostazioni del dispositivo — tema, dimensione del testo, larghezza della riga, modalità di visualizzazione, salvataggio automatico, intervallo di controllo, scorciatoie — riguardano lo schermo davanti al quale sei, e ogni dispositivo tiene le sue. Le impostazioni del vault — vocabolario delle proprietà, colori dei file, cartella degli allegati, preferiti, parole delle liste — riguardano le note, quindi viaggiano con loro.

• Aspetto — tema, dimensione del testo dell'editor, larghezza della riga.
• Editor — modalità di visualizzazione, salvataggio automatico e il suo ritardo, formato di incollaggio.
• Vault — aggiungerne uno, rileggere, verificare l'ambito, rimuovere.
• Proprietà — il vocabolario del vault e i suoi tipi.
• File — ordinamento, regole di colore, cartella degli allegati, dove finisce una nota nuova.
• Gmail: se un'etichetta di Gmail alimenta questo vault, quale, e ogni quanto.
• Liste — le parole che ogni lista propone.
• Sincronizzazione — ogni quanto chiedere le modifiche, e quale account è collegato.
• Layout — quale forma disegnare, quanti file restano aperti, se i blocchi sopra e sotto una nota partono chiusi.
• Scorciatoie — ogni assegnazione, e quelle che hai cambiato.
• Archiviazione — cosa è tenuto in questo browser, con il modo di svuotare ciascuna cosa.
• Attività — cosa sta girando e cosa è girato.
• Informazioni — la versione, i download per computer, e un ricaricamento che svuota tutte le cache.

Scorciatoie da tastiera

Mod è Cmd su un Mac e Ctrl altrove. Ognuna di queste si può cambiare in Impostazioni → Scorciatoie, e la palette dei comandi mostra l'assegnazione attuale accanto a ogni comando.

• Mod+Shift+P — palette dei comandi
• Mod+P — aprire un file per nome
• Mod+Shift+F — cercare in tutte le note
• Mod+, — impostazioni
• Mod+S — salvare
• Mod+[ e Mod+] — indietro e avanti
• Mod+B e Mod+Alt+B — le barre laterali sinistra e destra
• Mod+G — il grafo
• Mod+1, Mod+2 — titolo 1, titolo 2
• Nell'editor: Mod+B, Mod+I, Mod+E — grassetto, corsivo, codice
• Mod+K nell'editor — scrivere un collegamento
• Mod+Shift+V — incollare al contrario
• [[, #, / — completare un collegamento, un tag, un comando
• @, !, % su una riga di attività — scadenza, priorità, stato
• Esc — chiude quello che è aperto sopra la nota

Limiti da conoscere

• L'accesso anticipato è solo su invito, e la schermata di consenso di Google è in modalità Test finché l'app chiede l'ambito Drive completo. Vuol dire che tutti riapprovano circa una volta alla settimana, con un tocco, e che ogni utente va aggiunto a mano.
• I file Google sono di Google. Un Documento o un Foglio viene incorniciato da Drive e modificato lì; non viene convertito niente. L'app per computer è l'eccezione: lì la cornice è modificabile sul posto.
• Le app per computer sono macOS su Apple Silicon e Windows a 64 bit. Nessuna versione per Mac Intel, nessuna per Linux, e un iPad si presenta come un Mac e non può eseguire niente di tutto ciò — lì aggiungi il sito alla schermata Home.
• Un vault viene letto una volta prima che la ricerca sia completa. Su qualche migliaio di note la prima volta ci vuole un po'; l'app dice a che punto è, e lo dice anche la ricerca invece di sostenere che non c'è niente da trovare.
• La sincronizzazione con Gmail gira mentre l'app è aperta. Nessun server legge la tua posta in background, quindi un'etichetta messa mentre tutti i dispositivi sono chiusi viene presa la prossima volta che uno di loro apre Pergalino.

Se qualcosa qui non corrisponde a quello che vedi, ha ragione l'app e questa pagina è rimasta indietro: dillo e viene sistemata.