# Нотатки Apple

Як працює експорт Нотаток Apple, від під’єднання до розв’язання проблем.

## Під’єднання

Натисніть «підключити» на картці Нотаток Apple (під час першого запуску «підключити apple notes» на картці вітання). Панель відкривається в `~/Library/Group Containers/group.com.apple.notes`: натисніть «Вибрати цю папку», нічого не відкриваючи. Exporter читає там базу даних Нотаток, лише для читання. Потім натисніть «обрати теку» і «синхронізувати зараз».

## Куди потрапляють файли

Папка просто у вашій домашній папці, як-от `~/Documents`, отримує всередині папку `notes-export`; глибша папка, як-от `~/Documents/notes`, використовується як є. Рядок «експортувати до» показує справжню папку.

Вкладка, на якій залишено картку, задає й розкладку папок:

| вкладка | файли потрапляють у |
| --- | --- |
| Папки | власне дерево папок Нотаток Apple |
| Теги | папку з назвою першого позначеного тегу нотатки; нотатка без позначеного тегу пропускається |
| Смарт | папку з назвою її смарт-папки |

Перемикання між цими вкладками переміщує кожен файл під час наступної синхронізації, і картка повідомляє про це під вкладками. «Спільні», «Закріп.», «Останні» й «Часті» є списками: позначка там рахується як позначка на вкладці «Папки».

Файл називається за назвою нотатки, з видаленими `.` і заміною `/` та `:` на `_`. Дві нотатки з однаковою назвою в одній папці обидві отримують шість символів свого ідентифікатора, як-от `Meeting-3f9a1c.md`. Поруч із нотатками:

- `attachments/`, поруч із нотатками кожної папки
- `bases/`: `all-notes.base`, `photo-notes.base` і `all-attachments.base`, подання для Bases в Obsidian, які перезаписуються під час кожного експорту
- `.exporter/`: `last-export.json` і `last-export.md` для останнього запуску, `history/` з останніми 50 і `files.json`, перелік файлів, які записав Exporter

## Що експортується

Кожна нотатка в папках чи тегах, позначених на картці. Перше завантаження позначає все, а папки й теги, що з’являються пізніше, позначаються за вас; те, з чого ви зняли позначку, лишається непозначеним.

Пропускаються:

- заблоковані нотатки, тобто захищені паролем
- нотатки, які Нотатки Apple ще не завантажили з iCloud на цей Mac
- «Нещодавно видалені»
- нотатки смарт-папки з позначкою «тому нічого не експортується»: її пошук неможливо прочитати, тож позначте її нотатки на вкладці «Папки»

У файлі списки завдань стають `- [ ]` і `- [x]`, таблиці стають таблицями Markdown, виділення `==text==`, а посилання на інші нотатки `[[wikilinks]]`. Ваші #теги залишаються в тексті. Підкреслення й колір тексту відкидаються.

## Вкладення

Зображення, PDF, скани й малюнки копіюються в `attachments/` і вбудовуються там, де вони були, через `![[attachments/...]]`. Малюнок стає своїм зображенням, а розпізнаний Apple рукописний текст наводиться під ним як цитата. Вкладення, чийого файлу немає на цьому Mac, пропускається, і «Журнал експорту» показує його як «source file not found».

## Markdown і HTML

Типовий формат Markdown. «перемкнути на html» у рядку «формат» натомість записує одну вебсторінку на нотатку: стилі всередині, тож нічого не завантажується з інтернету; ідентифікатор і дати нотатки вгорі замість front matter; посилання між нотатками як посилання між сторінками; вкладення копіюються в `attachments/` поруч зі сторінкою й пов’язуються, тож переміщуйте сторінку разом із цією папкою.

Один формат за раз. Синхронізація видаляє лише старі файли того формату, який записує, тож після перемикання файли іншого формату залишаються: дайте кожному формату окрему папку. Сервер MCP читає лише Markdown.

## Файл

Ключі front matter, завжди в такому порядку; кожен пропускається, якщо не стосується нотатки:

| ключ | містить |
| --- | --- |
| `title` | назву нотатки |
| `id` | ідентифікатор нотатки в Нотатках Apple |
| `created`, `modified` | власний час Нотаток Apple, без часового поясу, у формі, яку Obsidian читає як дати |
| `source_url` | посилання `notes://`, яке знову відкриває нотатку в Нотатках Apple |
| `pinned`, `shared` | `true`, коли нотатку закріплено або надано до неї спільний доступ |
| `collaborators` | людей, з якими поділилися нотаткою |
| `cover` | перше зображення як вікіпосилання на його копію в `attachments/` |
| `links` | вебпосилання в нотатці |

Ключа `tags` немає. Нотатка в Travel > Norway, як `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]]
```

## Безкоштовно й після розблокування

Перші 100 нотаток експортуються й синхронізуються безкоштовно; нові нотатки понад це потребують одноразового розблокування ([ціни](https://exporter.dev/pricing)).

## Синхронізація й повна ресинхронізація

Після першого «синхронізувати зараз» кожна зміна в Нотатках Apple записується у свій файл, доки Exporter працює, з відкритим чи закритим вікном. Завершення роботи зупиняє це; `exporter sync` надолужує пропущене. Коли ви видаляєте, перейменовуєте або переміщуєте нотатку, наступна синхронізація видаляє її старий файл, і лише файли, перелічені в `.exporter/files.json`.

«повна ресинхронізація» спершу питає підтвердження, потім видаляє лише файли, які записав Exporter, експортує знову й знову вибирає безкоштовні 100. Усе інше в папці експорту залишається: ваші власні нотатки й `.obsidian` сховища.

## Проблеми й рішення

- «це не папка Apple Notes»: ви вибрали іншу папку. Натисніть «спробувати ще раз», потім «Вибрати цю папку», нічого не відкриваючи
- бракує заблокованої нотатки: зніміть блокування в Нотатках Apple. «Параметри» > «діагностика бази даних нотаток» рахує заблоковані нотатки
- бракує нотаток з iCloud: відкрийте Нотатки Apple і дочекайтеся завершення синхронізації, потім перевірте на картці лічильник «вибрано»
- файли перемістилися в інші папки: картку перемкнули на іншу вкладку. Поверніться на потрібну вкладку й натисніть «синхронізувати зараз»
- нотатку не вдалося експортувати: «остання синхронізація» показує червоне посилання «деталі». «apple notes саме записувала цю нотатку, її буде експортовано під час наступної синхронізації» минає само; якщо «не вдалося прочитати нотатку з бази даних» повторюється, надішліть звіт із «Параметри» > «діагностика бази даних нотаток» із назвою нотатки
- бракує зображення: відкрийте нотатку в Нотатках Apple, щоб її файл завантажився, і синхронізуйте знову
- зміни не з’являються: Exporter має працювати, а нотатка має бути позначена й у межах безкоштовного ліміту

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