# Apple Notes

Come funziona l'esportazione di Apple Notes, dal collegamento alla soluzione dei problemi.

## 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`:

```markdown
---
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](https://exporter.dev/pricing)).

## 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

## Related

- [Export Apple Notes to Markdown](https://exporter.dev/notes): Apple Notes as Markdown, kept in sync
- [Apple Notes guides](https://exporter.dev/guides/notes): Obsidian, backups, Claude and Wander
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

human version: https://exporter.dev/it/docs/notes
every page: https://exporter.dev/llms.txt