Apple Notes

Collegare

Prema “collega” sulla scheda Apple Notes (al primo avvio, “collega apple notes” sulla scheda di benvenuto). Il pannello si apre in ~/Library/Group Containers/group.com.apple.notes: prema “Seleziona questa cartella” senza aprire nulla. Exporter legge lì il database di Note, in sola lettura. Poi prema “scegli la cartella”, e “sincronizza ora”.

Dove vanno i file

Una cartella direttamente dentro la sua cartella Inizio, come ~/Documents, riceve al suo interno una cartella notes-export; una cartella più profonda, come ~/Documents/notes, viene usata così com’è. La riga esporta in mostra la cartella reale.

La vista su cui si trova la scheda è anche la disposizione delle cartelle:

vista	i file finiscono in
Cartelle	l’albero di cartelle di Apple Notes
Tag	una cartella con il nome del primo tag selezionato della nota; una nota senza tag selezionati resta fuori
Smart	una cartella con il nome della sua cartella smart

Passare da una vista all’altra sposta tutti i file alla sincronizzazione successiva, e la scheda lo dice sotto le viste. Condiv., Fissate, Recenti e Frequenti sono elenchi: una selezione lì conta come una selezione in Cartelle.

Un file prende il nome dal titolo della nota, senza . e con / e : trasformati in _. Due note con lo stesso titolo nella stessa cartella ricevono entrambe sei caratteri del loro id, come Meeting-3f9a1c.md. Accanto alle note:

• attachments/, accanto alle note di ogni cartella
• bases/: all-notes.base, photo-notes.base e all-attachments.base, viste per le Basi di Obsidian, riscritte a ogni esportazione
• .exporter/: last-export.json e last-export.md per l’ultima esecuzione, history/ con le ultime 50, e files.json, l’elenco dei file scritti da Exporter

Cosa viene esportato

Ogni nota nelle cartelle o nei tag selezionati sulla scheda. Il primo caricamento seleziona tutto, e le cartelle e i tag che compaiono in seguito vengono selezionati per lei; ciò che deseleziona resta deselezionato.

Restano fuori:

• le note bloccate, quelle con una password
• le note che Apple Notes non ha ancora scaricato da iCloud su questo Mac
• Eliminate di recente
• le note di una cartella smart segnata “quindi non esporta nulla”: la sua ricerca non è leggibile, quindi selezioni le sue note in Cartelle

Nel file, le checklist diventano - [ ] e - [x], le tabelle diventano tabelle Markdown, le evidenziazioni ==testo== e i link ad altre note [[wikilink]]. I suoi #tag restano nel testo. Sottolineature e colori del testo vengono scartati.

Allegati

Immagini, PDF, scansioni e disegni vengono copiati in attachments/ e incorporati dove si trovavano, con ![[attachments/...]]. Un disegno diventa la sua immagine, con la scrittura a mano riconosciuta da Apple citata sotto. Un allegato il cui file non è su questo Mac viene saltato, e il Log di esportazione lo elenca come “source file not found”.

Markdown e HTML

Markdown è il formato predefinito. “passa a html” sulla riga formato scrive invece una pagina web per nota: con gli stili al suo interno, così nulla viene caricato da internet; l’id e le date della nota in alto al posto del front matter; i link tra note come link tra pagine; gli allegati copiati in attachments/ accanto alla pagina e collegati, quindi sposti una pagina insieme a quella cartella.

Un formato alla volta. Una sincronizzazione rimuove solo i vecchi file del formato che scrive, quindi cambiando formato i file dell’altro restano: dia a ogni formato la sua cartella. Il server MCP legge solo Markdown.

Il file

Le chiavi del front matter, sempre in quest’ordine, ciascuna omessa quando non si applica:

chiave	contiene
title	il titolo della nota
id	l’id della nota in Apple Notes
created, modified	gli orari di Apple Notes, senza fuso orario, nella forma che Obsidian legge come date
source_url	un link notes:// che riapre la nota in Apple Notes
pinned, shared	true quando la nota è fissata o condivisa
collaborators	le persone con cui è condivisa una nota condivisa
cover	la prima immagine, come wikilink alla sua copia in attachments/
links	i link web nella nota

Non c’è una chiave tags. Una nota in Travel > Norway, come Travel/Norway/Bike tour, day 2.md:

---
title: "Bike tour, day 2"
id: "5B7E2C19"
created: 2025-06-21T20:14:02
modified: 2025-06-22T08:03:47
source_url: "notes://showNote?identifier=5B7E2C19"
links:
  - "https://www.visitnorway.com/"
---
# Bike tour, day 2

From Voss to Flåm. Ferry times are in [[Bike tour, day 1]].

![[attachments/Drawing 3f9a1c.png]]

Gratis e sbloccato

Le prime 100 note si esportano e restano sincronizzate gratis; le nuove note successive richiedono lo sblocco una tantum (prezzi).

Sincronizzazione e risincronizzazione completa

Dopo il primo “sincronizza ora”, ogni modifica in Apple Notes viene scritta nel suo file finché Exporter è in esecuzione, con la finestra aperta o chiusa. Uscire dall’app la ferma; exporter sync recupera il ritardo. Quando elimina, rinomina o sposta una nota, la sincronizzazione successiva rimuove il suo vecchio file, e solo i file elencati in .exporter/files.json.

“risincronizza tutto” chiede prima conferma, poi rimuove solo i file scritti da Exporter, esporta di nuovo e sceglie di nuovo le 100 note gratuite. Tutto il resto nella cartella di esportazione rimane: le sue note e la .obsidian di un vault.

Problemi e soluzioni

• “questa non è la cartella di Apple Notes”: ha scelto un’altra cartella. Prema “riprova”, poi “Seleziona questa cartella” senza aprire nulla
• manca una nota bloccata: rimuova il blocco in Apple Notes. Impostazioni > “diagnostica del database delle note” conta le note bloccate
• mancano note di iCloud: apra Apple Notes e lasci che finisca di sincronizzare, poi controlli il conteggio selezionate della scheda
• i file sono finiti in altre cartelle: la scheda è passata a un’altra vista. Torni alla vista che vuole e prema “sincronizza ora”
• una nota non è riuscita: ultima sincronizzazione mostra un link rosso “dettagli”. “apple notes stava scrivendo questa nota e verrà esportata alla prossima sincronizzazione” si risolve da solo; se “impossibile leggere la nota dal database” continua a non riuscire, invii il rapporto da Impostazioni > “diagnostica del database delle note” con il titolo della nota
• manca un’immagine: apra la nota in Apple Notes perché il suo file venga scaricato, poi sincronizzi di nuovo
• le modifiche non compaiono: Exporter deve essere in esecuzione, e la nota deve essere selezionata ed entro la quota gratuita