# Notion

Notion 내보내기가 작동하는 방식을, 연결부터 문제 해결까지.

## 연결

Exporter 홈의 「클라우드」에서 Notion 옆의 「연결」을 누릅니다. Apple로 로그인하면 브라우저에 Notion 페이지가 열리고, 거기서 Exporter가 읽을 수 있는 페이지를 고르고 접근을 허용합니다. Exporter는 Notion에 읽기만 요청합니다. Exporter로 돌아와 파일이 저장될 위치를 고르고 「이 폴더 사용」을 누릅니다.

Notion 토큰은 Exporter 서버에 봉인된 채로 있습니다. Mac은 그 서버에 로그인할 뿐 토큰을 갖지 않습니다.

## 페이지 공유

Exporter와 공유한 페이지만, 그 아래의 모든 페이지와 데이터베이스와 함께 동기화됩니다. 나중에 페이지를 추가하려면 Notion에서 그 페이지의 ⋯ 메뉴를 열고 exporter.dev 연결을 추가하세요. 다음 동기화 때 도착합니다. 공유를 멈춘 페이지는 다음 일일 점검 때 폴더에서 사라집니다.

## 항목 고르기

선택 페이지에는 공유된 모든 페이지와 데이터베이스가 선택된 채로 나오며, 「전체」「페이지」「데이터베이스」 세 탭이 있습니다. 원하지 않는 것의 선택을 해제하면 그 파일은 빠집니다.

## 파일이 가는 곳

`~/Documents`처럼 홈 폴더 바로 아래의 폴더에는 안에 `notion-export` 폴더가 생깁니다. 더 깊은 폴더는 그대로 쓰입니다.

- 페이지: Notion이 보여 주는 폴더에 제목으로 이름 붙여 놓입니다: `Projects/Plan Q4.md`. 아래에 페이지가 있는 페이지는 그 파일 옆에 자기 이름의 폴더가 있습니다.
- 데이터베이스: 데이터베이스 이름의 폴더에 행마다 파일 하나, 그리고 그 옆에 표 전체: `Projects/Tasks/Write the plan.md`와 `Projects/Tasks.csv`
- Notion이 호스팅하는 이미지와 파일: 페이지 폴더의 `attachments/`에 놓이고, 페이지에서 링크됩니다

제목의 `/`와 `:`는 공백이 됩니다. 한 폴더에 같은 제목의 페이지가 둘이면, 먼저 만든 쪽이 그 제목을 쓰고 다른 쪽은 ID의 앞 6자를 괄호에 넣어 붙입니다.

## 파일

페이지의 프런트매터에는 `title`, `id`, `created`, `modified`, `source_url`, 그리고 페이지가 속한 페이지나 데이터베이스를 가리키는 `parent`가 들어갑니다. 데이터베이스 행에는 Notion에서의 속성 이름 그대로, 데이터베이스의 순서대로 속성이 더해집니다: 텍스트, 숫자, 날짜, 참 또는 거짓, 이름 목록. 그다음 제목과 평범한 Markdown으로 된 페이지. 콜아웃은 아이콘이 붙은 인용으로, 토글은 details 블록으로 바뀌고, 색은 버려집니다. 내보낸 다른 페이지로의 링크는 그 파일로의 상대 링크입니다. 시간은 UTC입니다.

데이터베이스의 CSV는 속성마다 열 하나, 행마다 줄 하나이며 오래된 순서입니다.

## 동기화

Notion은 모든 수정, 이동, 삭제를 Exporter 서버에 알립니다. 서버가 파일을 다시 쓰고 Mac에 알리며, Mac이 내려받으므로 변경은 몇 분 안에 도착합니다. Notion 자체가 알리기까지 1~2분 기다립니다. 이름을 바꾸거나 옮긴 페이지는 파일과 첨부 파일도 함께 옮겨 갑니다. 「지금 동기화」는 먼저 서버에 묻고, 「전체 재동기화」는 모든 파일을 다시 씁니다.

## Exporter Cloud

처음 연결한 날부터 7일은 무료입니다. 그 뒤 Exporter Cloud는 App Store 구독입니다. Notion만, 또는 Linear, Notion과 앞으로 추가되는 모든 클라우드 소스를 포함한 All Cloud를 월간이나 연간으로. 플랜이 끝나면 동기화가 멈추고 파일은 남습니다. 30일 뒤 서버는 사본과 토큰을 삭제합니다.

## 계정

「설정」 › 「계정」에 로그인한 이메일이 나옵니다. 「로그아웃」은 다음 로그인을 위해 연결을 남겨 둡니다. Notion 연결을 해제하면 Notion에서 Exporter의 접근이 취소되고 exporter.dev에 있는 Exporter의 사본이 삭제됩니다. 「계정 삭제…」는 모든 워크스페이스의 연결을 끊고 서버가 보관한 모든 것을 삭제합니다. Mac의 파일은 남습니다.

## 명령줄

`exporter export --source notion --dest <folder>`는 명령줄 카드에서 허용한 폴더에 워크스페이스 파일을 씁니다. [명령줄](https://exporter.dev/docs/cli)을 참고하세요.

## 문제와 해결

- 페이지가 없음: Notion에서 그 페이지의 ⋯ 메뉴로 exporter.dev 연결과 공유하고, 선택되어 있는지 확인한 뒤 「지금 동기화」를 누르세요.
- 이미지가 링크로 보임: Notion이 내주지 않아서, 파일이 대신 Notion에 있는 이미지로 링크합니다.
- 카드에 「다시 연결…」이 보임: Notion이 더 이상 연결을 받아들이지 않습니다. 대개 Notion 설정에서 연결이 제거된 경우입니다. 눌러서 다시 접근을 허용하세요.
- 카드에 「로그인…」이 보임: 세션이 끝났습니다. 같은 Apple 계정으로 로그인하면 동기화가 이어집니다.

## Related

- [Notion](https://exporter.dev/ko/notion): 페이지와 데이터베이스를 파일로
- [Notion 가이드](https://exporter.dev/ko/guides/notion): Obsidian과 백업
- [가격](https://exporter.dev/ko/pricing): 무료 한도, 잠금 해제와 Exporter Cloud

---

human version: https://exporter.dev/ko/docs/notion
every page: https://exporter.dev/llms.txt