# Apple Notities

Hoe de export van Apple Notities werkt, van verbinden tot problemen oplossen.

## Verbinden

Druk op "verbinden" op de kaart Apple Notities (bij de eerste start "apple notes verbinden" op de welkomstkaart). Het paneel opent in `~/Library/Group Containers/group.com.apple.notes`: druk op "Kies deze map" zonder iets te openen. Exporter leest daar de database van Notities, alleen-lezen. Druk daarna op "exportmap kiezen" en op "nu synchroniseren".

## Waar de bestanden komen

Een map direct in je thuismap, zoals `~/Documents`, krijgt daarin een map `notes-export`; een diepere map, zoals `~/Documents/notes`, wordt gebruikt zoals hij is. De rij `exporteren naar` toont de echte map.

Het tabblad waarop de kaart staat, is ook de mapindeling:

| tabblad | bestanden komen in |
| --- | --- |
| Mappen | de eigen mappenstructuur van Apple Notities |
| Tags | een map genoemd naar de eerste aangevinkte tag van de notitie; een notitie zonder aangevinkte tag blijft weg |
| Slim | een map genoemd naar de slimme map |

Wisselen tussen deze tabbladen verplaatst bij de volgende synchronisatie elk bestand, en de kaart meldt dat onder de tabbladen. Gedeeld, Vastgem., Recent en Populair zijn lijsten: een vinkje daar telt als een vinkje op Mappen.

Een bestand heet naar de titel van de notitie, met `.` weggelaten en `/` en `:` omgezet in `_`. Twee notities met dezelfde titel in één map krijgen allebei zes tekens van hun id, zoals `Meeting-3f9a1c.md`. Naast de notities:

- `attachments/`, naast de notities van elke map
- `bases/`: `all-notes.base`, `photo-notes.base` en `all-attachments.base`, weergaven voor Bases in Obsidian, bij elke export opnieuw geschreven
- `.exporter/`: `last-export.json` en `last-export.md` voor de laatste export, `history/` met de laatste 50, en `files.json`, de lijst met bestanden die Exporter schreef

## Wat wordt geëxporteerd

Elke notitie in de mappen of tags die op de kaart zijn aangevinkt. Bij het eerste laden is alles aangevinkt, en mappen en tags die later verschijnen, worden voor je aangevinkt; wat je uitvinkt, blijft uitgevinkt.

Blijft weg:

- vergrendelde notities, die met een wachtwoord
- notities die Apple Notities nog niet van iCloud naar deze Mac heeft gedownload
- Recent verwijderd
- de notities van een slimme map met de melding "dus exporteert ze niets": de zoekopdracht is niet leesbaar, dus vink de notities ervan aan op Mappen

In het bestand worden checklists `- [ ]` en `- [x]`, tabellen Markdown-tabellen, markeringen `==text==` en links naar andere notities `[[wikilinks]]`. Je #tags blijven in de tekst staan. Onderstreping en tekstkleuren vervallen.

## Bijlagen

Afbeeldingen, pdf's, scans en tekeningen worden gekopieerd naar `attachments/` en ingesloten op de plek waar ze stonden, met `![[attachments/...]]`. Een tekening wordt haar afbeelding, met eventueel handschrift dat Apple herkende eronder geciteerd. Een bijlage waarvan het bestand niet op deze Mac staat, wordt overgeslagen, en het Exportlogboek vermeldt haar als "source file not found".

## Markdown en HTML

Markdown is de standaard. "overschakelen naar html" in de rij `formaat` schrijft in plaats daarvan één webpagina per notitie: met de opmaak erin, zodat er niets van internet laadt; het id en de datums van de notitie bovenaan in plaats van front matter; links tussen notities als links tussen pagina's; bijlagen gekopieerd naar `attachments/` naast de pagina en gelinkt, dus verplaats een pagina samen met die map.

Eén formaat tegelijk. Een synchronisatie verwijdert alleen oude bestanden van het formaat dat ze schrijft, dus van formaat wisselen laat de bestanden van het andere formaat staan: geef elk formaat een eigen map. De MCP-server leest alleen Markdown.

## Het bestand

De sleutels van de front matter, altijd in deze volgorde, elk weggelaten als hij niet van toepassing is:

| sleutel | bevat |
| --- | --- |
| `title` | de titel van de notitie |
| `id` | het id van de notitie in Apple Notities |
| `created`, `modified` | de eigen tijden van Apple Notities, zonder tijdzone, in de vorm die Obsidian als datums leest |
| `source_url` | een `notes://`-link die de notitie weer opent in Apple Notities |
| `pinned`, `shared` | `true` als de notitie is vastgezet of gedeeld |
| `collaborators` | de personen met wie een gedeelde notitie is gedeeld |
| `cover` | de eerste afbeelding, als wikilink naar de kopie in `attachments/` |
| `links` | de weblinks in de notitie |

Er is geen sleutel `tags`. Een notitie in Travel > Norway, als `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 en ontgrendeld

Je eerste 100 notities exporteer en synchroniseer je gratis; nieuwe notities daarna vragen de eenmalige ontgrendeling ([prijzen](https://exporter.dev/pricing)).

## Synchroniseren en volledig opnieuw synchroniseren

Na de eerste "nu synchroniseren" wordt elke wijziging in Apple Notities naar het bestand geschreven zolang Exporter draait, met het venster open of dicht. Afsluiten stopt het; `exporter sync` haalt de achterstand in. Verwijder, hernoem of verplaats je een notitie, dan verwijdert de volgende synchronisatie het oude bestand, en alleen bestanden die in `.exporter/files.json` staan.

"volledig opnieuw synchroniseren" vraagt eerst om bevestiging, verwijdert dan alleen de bestanden die Exporter schreef, exporteert opnieuw en kiest de gratis 100 opnieuw. Al het andere in de exportmap blijft staan: je eigen notities, en de `.obsidian` van een vault.

## Problemen en oplossingen

- "dat is niet de map van Apple Notities": je koos een andere map. Druk op "opnieuw proberen" en daarna op "Kies deze map" zonder iets te openen
- er ontbreekt een vergrendelde notitie: haal de vergrendeling weg in Apple Notities. Instellingen > "diagnose van de notitiesdatabase" telt de vergrendelde notities
- er ontbreken iCloud-notities: open Apple Notities en laat het synchroniseren afmaken, en controleer dan het aantal `geselecteerd` op de kaart
- bestanden zijn naar andere mappen verplaatst: de kaart is naar een ander tabblad gegaan. Ga terug naar het tabblad dat je wilt en druk op "nu synchroniseren"
- een notitie is mislukt: `laatste synchronisatie` toont een rode link "details". "apple notes was deze notitie aan het schrijven, ze wordt bij de volgende synchronisatie geëxporteerd" lost zichzelf op; blijft "kon de notitie niet uit de database lezen" mislukken, stuur dan het rapport vanuit Instellingen > "diagnose van de notitiesdatabase" met de titel van de notitie
- er ontbreekt een afbeelding: open de notitie in Apple Notities zodat het bestand wordt gedownload, en synchroniseer opnieuw
- wijzigingen verschijnen niet: Exporter moet draaien, en de notitie moet aangevinkt zijn en binnen de gratis hoeveelheid vallen

## 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/nl/docs/notes
every page: https://exporter.dev/llms.txt