# Notatki Apple

Jak działa eksport Notatek Apple, od połączenia po naprawianie problemów.

## Połączenie

Naciśnij „połącz” na karcie Notatek Apple (przy pierwszym uruchomieniu „połącz apple notes” na karcie powitalnej). Panel otworzy się w `~/Library/Group Containers/group.com.apple.notes`: naciśnij „Wybierz ten folder”, niczego nie otwierając. Exporter czyta tam bazę danych Notatek, tylko do odczytu. Potem naciśnij „wybierz folder eksportu” i „synchronizuj teraz”.

## Gdzie trafiają pliki

Folder leżący bezpośrednio w twoim folderze domowym, na przykład `~/Documents`, dostaje w środku folder `notes-export`; głębszy folder, na przykład `~/Documents/notes`, jest używany bez zmian. Wiersz `eksportuj do` pokazuje faktyczny folder.

Zakładka, na której jest karta, wyznacza też układ folderów:

| zakładka | pliki trafiają do |
| --- | --- |
| Foldery | własnego drzewa folderów Notatek Apple |
| Tagi | folderu nazwanego jak pierwszy zaznaczony tag notatki; notatka bez zaznaczonego tagu jest pomijana |
| Smart | folderu nazwanego jak jej folder inteligentny |

Przełączenie między tymi zakładkami przenosi każdy plik przy następnej synchronizacji, a karta informuje o tym pod zakładkami. Wspólne, Przypięte, Ostatnie i Częste to listy: zaznaczenie tam liczy się jak zaznaczenie na zakładce Foldery.

Plik nosi nazwę tytułu notatki, z usuniętymi `.` i ze znakami `/` oraz `:` zamienionymi na `_`. Dwie notatki o tym samym tytule w jednym folderze dostają obie sześć znaków swojego id, na przykład `Meeting-3f9a1c.md`. Obok notatek:

- `attachments/`, obok notatek z każdego folderu
- `bases/`: `all-notes.base`, `photo-notes.base` i `all-attachments.base`, widoki dla Bases w Obsidian, nadpisywane przy każdym eksporcie
- `.exporter/`: `last-export.json` i `last-export.md` z ostatniego uruchomienia, `history/` z ostatnimi 50 oraz `files.json`, lista plików zapisanych przez Exporter

## Co jest eksportowane

Każda notatka z folderów lub tagów zaznaczonych na karcie. Pierwsze wczytanie zaznacza wszystko, a foldery i tagi, które pojawią się później, są zaznaczane za ciebie; to, co odznaczysz, zostaje odznaczone.

Pomijane:

- zablokowane notatki, te z hasłem
- notatki, których Notatki Apple nie pobrały jeszcze z iCloud na tego Maca
- Ostatnio usunięte
- notatki folderu inteligentnego oznaczonego „więc nic nie zostanie wyeksportowane”: jego wyszukiwania nie da się odczytać, więc zaznacz jego notatki na zakładce Foldery

W pliku listy kontrolne stają się `- [ ]` i `- [x]`, tabele tabelami Markdown, wyróżnienia `==text==`, a linki do innych notatek `[[wikilinks]]`. Twoje #tagi zostają w tekście. Podkreślenia i kolory tekstu są pomijane.

## Załączniki

Obrazy, pliki PDF, skany i rysunki są kopiowane do `attachments/` i osadzane tam, gdzie były, przez `![[attachments/...]]`. Rysunek staje się swoim obrazem, a pismo odręczne rozpoznane przez Apple jest cytowane pod nim. Załącznik, którego pliku nie ma na tym Macu, jest pomijany, a Dziennik eksportu wymienia go jako „source file not found”.

## Markdown i HTML

Markdown jest domyślny. „przełącz na html” w wierszu `format` zapisuje zamiast tego jedną stronę internetową na notatkę: ze stylami w środku, więc nic nie wczytuje się z internetu; z id i datami notatki na górze zamiast frontmattera; z linkami między notatkami jako linkami między stronami; z załącznikami skopiowanymi do `attachments/` obok strony i linkowanymi, więc przenoś stronę razem z tym folderem.

Jeden format naraz. Synchronizacja usuwa tylko stare pliki formatu, który zapisuje, więc po przełączeniu pliki drugiego formatu zostają w folderze: daj każdemu formatowi własny folder. Serwer MCP czyta tylko Markdown.

## Plik

Klucze frontmattera, zawsze w tej kolejności, każdy pomijany, gdy nie ma zastosowania:

| klucz | zawiera |
| --- | --- |
| `title` | tytuł notatki |
| `id` | id notatki w Notatkach Apple |
| `created`, `modified` | czasy z Notatek Apple, bez strefy czasowej, w formie, którą Obsidian czyta jako daty |
| `source_url` | link `notes://`, który ponownie otwiera notatkę w Notatkach Apple |
| `pinned`, `shared` | `true`, gdy notatka jest przypięta lub udostępniona |
| `collaborators` | osoby, którym udostępniono notatkę |
| `cover` | pierwszy obraz, jako wikilink do jego kopii w `attachments/` |
| `links` | linki internetowe w notatce |

Nie ma klucza `tags`. Notatka w Travel > Norway, jako `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]]
```


## Darmowe i odblokowane

Pierwsze 100 notatek eksportujesz i synchronizujesz za darmo; nowe notatki ponad to wymagają jednorazowego odblokowania ([cennik](https://exporter.dev/pricing)).

## Synchronizacja i pełna resynchronizacja

Po pierwszym „synchronizuj teraz” każda zmiana w Notatkach Apple trafia do swojego pliku, dopóki Exporter działa, przy otwartym lub zamkniętym oknie. Zakończenie aplikacji to zatrzymuje; `exporter sync` nadrabia zaległości. Gdy usuniesz, przemianujesz lub przeniesiesz notatkę, następna synchronizacja usuwa jej stary plik, i tylko pliki wymienione w `.exporter/files.json`.

„pełna resynchronizacja” najpierw pyta, potem usuwa tylko pliki zapisane przez Exporter, eksportuje ponownie i od nowa wybiera darmową setkę. Wszystko inne w folderze eksportu zostaje: twoje własne notatki i `.obsidian` vaulta.

## Problemy i poprawki

- „to nie jest folder Notatek Apple”: wybrałeś inny folder. Naciśnij „spróbuj ponownie”, a potem „Wybierz ten folder”, niczego nie otwierając
- brakuje zablokowanej notatki: usuń blokadę w Notatkach Apple. Ustawienia > „diagnostyka bazy danych notatek” liczy zablokowane notatki
- brakuje notatek z iCloud: otwórz Notatki Apple i pozwól im dokończyć synchronizację, a potem sprawdź liczbę `zaznaczone` na karcie
- pliki przeniosły się do innych folderów: karta przeszła na inną zakładkę. Wróć na zakładkę, którą chcesz, i naciśnij „synchronizuj teraz”
- eksport notatki się nie udał: `ostatnia synchronizacja` pokazuje czerwony link „szczegóły”. „notatki apple właśnie zapisywały tę notatkę, zostanie wyeksportowana przy następnej synchronizacji” rozwiązuje się samo; jeśli „nie udało się odczytać notatki z bazy danych” wciąż się powtarza, wyślij raport z Ustawienia > „diagnostyka bazy danych notatek” z tytułem notatki
- brakuje obrazu: otwórz notatkę w Notatkach Apple, żeby jej plik się pobrał, i zsynchronizuj ponownie
- zmiany się nie pojawiają: Exporter musi działać, a notatka musi być zaznaczona i mieścić się w darmowym limicie

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