# Apple 메모

연결부터 문제 해결까지, Apple 메모 내보내기가 작동하는 방식입니다.

## 연결

Apple 메모 카드에서 “연결”을 누릅니다(처음 실행할 때는 환영 카드의 “Apple 메모 연결”). 패널이 `~/Library/Group Containers/group.com.apple.notes`에서 열리면 아무것도 열지 말고 “이 폴더 선택”을 누릅니다. Exporter는 그곳의 메모 데이터베이스를 읽기 전용으로 읽습니다. 그다음 “내보낼 폴더 선택”을 누르고 “지금 동기화”를 누릅니다.

## 파일이 저장되는 위치

`~/Documents`처럼 홈 폴더 바로 아래의 폴더를 고르면 그 안에 `notes-export` 폴더가 생기고, `~/Documents/notes`처럼 더 깊은 폴더는 그대로 사용됩니다. “내보내기 위치” 행에 실제 폴더가 표시됩니다.

카드에서 선택한 탭이 곧 폴더 구성입니다:

| 탭 | 파일이 저장되는 곳 |
| --- | --- |
| 폴더 | Apple 메모 자체의 폴더 트리 |
| 태그 | 메모에서 처음 선택된 태그의 이름을 딴 폴더. 선택된 태그가 없는 메모는 제외됩니다 |
| 스마트 | 스마트 폴더의 이름을 딴 폴더 |

이 탭들 사이를 전환하면 다음 동기화에서 모든 파일이 옮겨지며, 카드의 탭 아래에 그렇게 표시됩니다. “공유”, “고정”, “최근”, “자주 본”은 목록입니다. 여기서 선택하면 “폴더”에서 선택한 것으로 칩니다.

파일 이름은 메모 제목을 따르며, `.`은 지워지고 `/`와 `:`는 `_`로 바뀝니다. 한 폴더에 제목이 같은 메모가 두 개 있으면 둘 다 `Meeting-3f9a1c.md`처럼 ID의 여섯 글자가 붙습니다. 메모 옆에는 다음이 있습니다:

- `attachments/`: 각 폴더의 메모 옆
- `bases/`: `all-notes.base`, `photo-notes.base`, `all-attachments.base`. Obsidian 베이스용 보기이며, 내보낼 때마다 다시 쓰입니다
- `.exporter/`: 마지막 실행의 `last-export.json`과 `last-export.md`, 최근 50번을 담은 `history/`, Exporter가 쓴 파일 목록인 `files.json`

## 내보내지는 것

카드에서 선택한 폴더나 태그의 모든 메모입니다. 처음 불러올 때 모든 항목이 선택되며, 나중에 생긴 폴더와 태그도 자동으로 선택됩니다. 선택 해제한 항목은 해제된 상태로 남습니다.

제외되는 것:

- 잠긴 메모(암호가 걸린 메모)
- Apple 메모가 아직 iCloud에서 이 Mac으로 다운로드하지 않은 메모
- 최근 삭제된 항목
- “아무것도 내보내지 않습니다”라고 표시된 스마트 폴더의 메모. 검색 조건을 읽을 수 없으므로 “폴더”에서 해당 메모를 선택하세요

파일 안에서 체크리스트는 `- [ ]`와 `- [x]`로, 표는 Markdown 표로, 하이라이트는 `==text==`로, 다른 메모로의 링크는 `[[wikilinks]]`로 바뀝니다. #태그는 본문에 남습니다. 밑줄과 텍스트 색상은 빠집니다.

## 첨부 파일

이미지, PDF, 스캔, 드로잉은 `attachments/`에 복사되고 원래 있던 자리에 `![[attachments/...]]`로 삽입됩니다. 드로잉은 이미지가 되며, Apple이 인식한 손글씨가 있으면 그 아래에 인용됩니다. 파일이 이 Mac에 없는 첨부 파일은 건너뛰며, 내보내기 로그에 “source file not found”로 나열됩니다.

## Markdown과 HTML

기본은 Markdown입니다. `format` 행의 “HTML로 전환”을 누르면 대신 메모마다 웹 페이지 하나를 씁니다. 스타일이 페이지 안에 들어 있어 인터넷에서 아무것도 불러오지 않고, 프런트매터 대신 메모의 ID와 날짜가 맨 위에 있으며, 메모 사이의 링크는 페이지 사이의 링크가 되고, 첨부 파일은 페이지 옆 `attachments/`에 복사되어 링크되므로 페이지를 옮길 때는 그 폴더와 함께 옮기세요.

한 번에 한 형식입니다. 동기화는 자신이 쓰는 형식의 오래된 파일만 지우므로, 형식을 바꾸면 다른 형식의 파일이 남습니다. 형식마다 폴더를 따로 주세요. MCP 서버는 Markdown만 읽습니다.

## 파일

프런트매터 키는 항상 이 순서이며, 해당하지 않는 키는 빠집니다:

| 키 | 담는 내용 |
| --- | --- |
| `title` | 메모 제목 |
| `id` | Apple 메모가 메모에 부여한 ID |
| `created`, `modified` | Apple 메모 자체의 시각. 시간대 없이, Obsidian이 날짜로 읽는 형식 |
| `source_url` | Apple 메모에서 해당 메모를 다시 여는 `notes://` 링크 |
| `pinned`, `shared` | 메모가 고정되었거나 공유되었으면 `true` |
| `collaborators` | 공유된 메모를 함께 쓰는 사람들 |
| `cover` | 첫 번째 이미지. `attachments/`에 있는 사본으로의 위키링크 |
| `links` | 메모 안의 웹 링크 |

`tags` 키는 없습니다. 여행 > 노르웨이에 있는 메모는 `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)).

## 동기화와 전체 재동기화

처음 “지금 동기화”를 누른 뒤로는 Exporter가 실행 중인 동안 창이 열려 있든 닫혀 있든 Apple 메모의 모든 편집이 해당 파일에 기록됩니다. 앱을 종료하면 멈추며, `exporter sync`로 따라잡을 수 있습니다. 메모를 삭제하거나 이름을 바꾸거나 옮기면 다음 동기화에서 이전 파일이 지워지며, 지워지는 것은 `.exporter/files.json`에 기록된 파일뿐입니다.

“전체 재동기화”는 먼저 확인을 요청한 다음, Exporter가 쓴 파일만 지우고 다시 내보내며 무료 100개를 다시 고릅니다. 내보내기 폴더의 다른 것은 그대로 남습니다. 직접 쓴 메모와 보관소의 `.obsidian`도 마찬가지입니다.

## 문제와 해결 방법

- “Apple 메모 폴더가 아닙니다”: 다른 폴더를 골랐습니다. “다시 시도”를 누른 다음, 아무것도 열지 말고 “이 폴더 선택”을 누르세요
- 잠긴 메모가 없음: Apple 메모에서 잠금을 해제하세요. 설정 > “메모 데이터베이스 진단”에서 잠긴 메모 수를 셉니다
- iCloud 메모가 없음: Apple 메모를 열어 동기화가 끝나게 한 다음, 카드의 “선택” 개수를 확인하세요
- 파일이 다른 폴더로 옮겨짐: 카드의 탭이 바뀌었습니다. 원하는 탭으로 돌아가 “지금 동기화”를 누르세요
- 메모 내보내기 실패: “마지막 동기화”에 빨간 “자세히” 링크가 표시됩니다. “Apple 메모가 이 메모를 저장하는 중이었습니다. 다음 동기화에서 내보내집니다”는 저절로 해결됩니다. “데이터베이스에서 메모를 읽을 수 없습니다”가 계속되면 설정 > “메모 데이터베이스 진단”에서 메모 제목과 함께 보고서를 보내세요
- 이미지가 없음: 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/ko/docs/notes
every page: https://exporter.dev/llms.txt