Salta al contenuto
Guida di Varlig
Pagina iniziale di Varlig

Modificare file Markdown sul posto

Alcuni file Markdown si trovano fuori dalla libreria: un README in un repository Git, un file in iCloud Drive o note ricevute da un collega. Varlig può modificarli nella loro posizione, senza copiarli nella libreria.

Aprire un file

Scegli File › Open Markdown File… (⌥⌘O), apri il file dal Finder con Open With ▸ Varlig, oppure esegui open -a Varlig notes.md in Terminal. Varlig apre file .md, .markdown, .txt e altri file di testo semplice simili, fino a 32 MB.

La finestra del file usa lo stesso editor delle note. Nell’intestazione mostra l’etichetta FILE, il nome del file, la cartella e lo stato del salvataggio. Il pulsante della cartella mostra il file nel Finder.

Aprire una cartella

Scegli File › Open Folder… (⌃⌘O), trascina una cartella sull’icona di Varlig nel Dock oppure esegui open -a Varlig ~/Projects/handbook in Terminal. La finestra della cartella elenca i file Markdown e di testo nella barra laterale, raggruppati per sottocartella. Il file selezionato si modifica nello stesso editor usato per i singoli file. Se presente, viene aperto prima il README; quando torni, ritrovi l’ultimo file letto.

L’elenco segue i cambiamenti nella cartella: aggiunte, eliminazioni e rinominazioni fatte da un’altra app o da git checkout compaiono automaticamente. Sono escluse le cartelle nascoste, come .git, e node_modules. Filter files filtra per nome o percorso; + crea un file vuoto Untitled.md accanto a quello aperto. Passare a un altro file salva quello che lasci, e un link relativo a un file nella stessa cartella lo apre nella stessa finestra.

Varlig non aggiunge nulla alla cartella oltre ai tuoi file: nessun database o impostazione nascosta. Puoi quindi continuare a spostarla e copiarla liberamente.

Salvataggio

Le modifiche si salvano circa un secondo dopo aver smesso di digitare e File › Save (⌘S) salva immediatamente. L'intestazione mostra Saved, Edited o Save failed con il motivo.

Varlig conserva il formato originale del file: le terminazioni di riga, l’eventuale byte-order mark e l’a capo finale, solo se era già presente. Le scritture sono atomiche e mantengono i permessi del file, così Git mostra differenze chiare e limitate alle modifiche effettive.

File › Save As… salva una copia in un’altra posizione e prosegue la modifica su quella copia.

I riferimenti relativi partono dalla cartella del file: ![](diagrams/flow.png) e [the plan](plan.md) aprono i contenuti previsti, fino a tre cartelle superiori. Un’immagine incollata o trascinata nell’editor viene salvata accanto al file, in una cartella che ne riprende il nome, come notes.assets/.

In una finestra di file, i tag e [[note links]] sono testo normale: queste funzioni appartengono alla libreria e il file su disco non dispone di un posto in cui conservarne i dati.

Quando il file cambia sul disco

Se qualcos'altro cambia il file mentre hai modifiche non salvate - un git pull, un client di sincronizzazione, un altro editor - Varlig mantiene entrambe le versioni e lo dice:

  • Compare… mostra le due versioni affiancate, evidenziando ciò che compare solo sul disco e ciò che compare solo nella finestra.
  • Keep Mine salva la tua versione e conserva la versione del disco come copia datata accanto al file.
  • Use Disk Version mostra la versione del disco e mantiene la tua come copia datata accanto al file.

In entrambi i casi non viene sovrascritto nulla. Le copie hanno nomi che permettono di distinguerle, come notes (disk version 2026-09-22 1415).md.

Se il file viene spostato o eliminato mentre lo modifichi, Varlig ti avvisa e offre Save As…, così puoi comunque salvare il testo.

I formati dei risultati restano nel file

Il formato del risultato di una riga — cifre decimali, separatori e notazione — e l’impostazione Subtotal o Time Point vengono conservati nei metadati del file, in un attributo esteso, senza modificare il Markdown. Il testo resta intatto e, quando riapri il file da solo o in una cartella, ogni riga appare come l’avevi lasciata. Le righe modificate, inserite o spostate mantengono le proprie impostazioni; se il testo di una riga viene eliminato, vengono rimosse anche le impostazioni, senza assegnarle a un’altra riga.

Alcuni strumenti non conservano gli attributi estesi: Git, la maggior parte delle utilità ZIP, alcuni servizi di sincronizzazione e i dischi formattati per Windows. In questi casi vengono ripristinati i formati predefiniti, senza modificare il testo. Per impedire del tutto a Varlig di usare i metadati del file, disattiva Remember answer formats in Markdown files in Settings › Editor. L’opzione è attiva per impostazione predefinita.

Differenze nella finestra di un file

  • Non sono disponibili cronologia delle versioni, protezione con password o backup: il file sul disco è l’unica copia.
  • I blocchi di calcolo funzionano normalmente. Il formato del risultato e le impostazioni scelti per una singola riga vengono conservati con il file, come descritto sopra, non nel suo testo.
  • I link varlig:// aprono una nota; non eseguono mai automazioni da un file.