Google Keep → 마크다운 변환기

사용 방법

1. 1

   Google Takeout에서 Keep 데이터 요청

   Google Takeout에서 Keep만 선택해 내보내기를 만들고 ZIP을 내려받으세요. 원본은 그대로 백업해 둡니다. 변환기는 메모가 Keep이라는 폴더에 있는 표준 구조를 기대합니다.

2. 2

   변환기에서 ZIP 열기

   .zip 파일을 끌어다 놓거나 선택하세요. 먼저 결과를 보고 싶다면 기본 제공 샘플 내보내기를 열 수 있습니다. 압축 상태 25MiB 이하, 항목 5,000개 이하, 압축을 풀었을 때 전체 100MiB 이하여야 합니다.

3. 3

   출력 옵션을 고르고 변환

   머리말 항목을 켜고 끄고, 파일 이름을 제목 또는 생성 날짜 + 제목으로 정하고, 첨부 파일 폴더 이름을 바꾸고, 라벨을 labels나 tags로 쓸지 선택합니다. 변환은 자동으로 실행되고 옵션을 바꾸면 다시 실행됩니다. 진행 막대가 검증, 변환, 압축 단계를 보여 주며, 노트를 쓰기 전에 모든 파일의 무결성을 검사하고 손상된 아카이브는 결과물 없이 중단됩니다.

4. 4

   대시보드와 경고 읽기

   결과는 완료, 부분, 비어 있음 중 하나이고 노트, 체크리스트, 첨부, 경고 수와 실패·미지원 파일 수가 표시됩니다. 경고는 코드별 개수로 나열되며 코드를 누르면 해당 파일과 필드 위치를 볼 수 있습니다.

5. 5

   노트 검색과 미리보기

   제목, 라벨, 본문으로 검색한 뒤 노트를 열어 렌더링된 모습이나 마크다운 원문을 봅니다. 미리보기는 안전합니다. 링크와 이미지는 글자로만 표시되고 노트 안의 어떤 내용도 실행되지 않습니다. 긴 노트는 미리보기에서만 잘립니다.

6. 6

   ZIP과 보고서 내려받기

   노트와 첨부 파일이 든 google-keep-markdown.zip과 전체 기록이 든 preservation-report.json을 내려받습니다. 내려받기는 변환이 성공한 뒤에만 켜집니다.

작동 원리

createdTimestampUsec: 1700000000000000   ->  created: 2023-11-14T22:13:20.000000Z
userEditedTimestampUsec: 1700000100123456 ->  updated: 2023-11-14T22:15:00.123456Z

실제 예시

Keep/Shopping.json: title Shopping, textContent "Milk\nEggs", labels [home], isPinned true, color YELLOW, 생성 1700000000000000, 수정 1700000100123456, 첨부 photo.jpg

notes/Shopping.md
---
title: Shopping
labels:
  - home
isPinned: true
color: YELLOW
createdTimestampUsec: "1700000000000000"
created: 2023-11-14T22:13:20.000000Z
userEditedTimestampUsec: "1700000100123456"
updated: 2023-11-14T22:15:00.123456Z
---

# Shopping

Milk  
Eggs

[photo.jpg](../assets/photo.jpg)

Keep/Todo.json: title "Todo: a/b", listContent [bread 체크됨, "call *mom*" 체크 안 됨]

파일 notes/Todo_ a_b.md, 본문 줄: "# Todo: a/b", "- [x] bread", "- [ ] call \*mom\*"

Keep/Tags.json: title Tags, labels ["home office"], 생성 1700000000000000, 타임스탬프와 날짜 항목은 끄고 라벨을 tags로 저장

---
title: Tags
tags:
  - home-office
---

# Tags

textContent 없이 textContentHtml만 있는 Keep/Rich.json

변환하지 않음. 결과 unsupported, 이유 RICH_TEXT_ONLY와 FORMATTING_NOT_PRESERVED, 필드 값은 preservation-report.json에 보관

자주 하는 실수

• 서식은 옮겨지지 않습니다

  변환기는 일반 텍스트와 체크리스트만 매핑합니다. HTML 필드에만 있는 서식은 변환되지 않고, 서식 있는 텍스트로만 존재하는 노트는 미지원으로 보고됩니다. 경고에서 FORMATTING_NOT_PRESERVED를 확인하세요.

• 체크리스트는 평평해집니다

  체크된 항목과 안 된 항목이 저장된 순서대로 하나의 평평한 작업 목록이 됩니다. 중첩이나 재정렬된 구조는 복원하지 않으며, LIST_FLATTENED 경고가 어떤 노트가 해당되는지 알려 줍니다.

• 매핑하지 않는 필드는 노트가 아니라 보고서에 남습니다

  링크 주석 같은 알 수 없거나 미지원인 필드는 경고로 세고 값은 마크다운이 아니라 preservation-report.json에 저장합니다. 무언가 빠진 것 같으면 보고서를 열어 보세요.

• 머리말 항목을 끄면 노트에서 그 정보가 빠집니다

  끈 항목은 어느 노트에도 쓰이지 않습니다. 보고서에는 생략으로 표시되므로 내보내기에서 사라지는 것은 아니지만 마크다운 파일에는 더 이상 들어 있지 않습니다. 나중에 필요할 수 있다면 날짜와 상태는 켜 두세요.

• 크기 제한이 엄격합니다

  압축 상태 25MiB 초과, 항목 5,000개 초과, 항목 하나가 10MiB를 넘는 해제, 전체 해제 100MiB 초과, 압축률 200배 초과인 ZIP은 거절됩니다. Keep 내보내기에 큰 오디오가 많다면 더 작게 나눠서 Takeout을 요청하세요.

• 경로가 모호한 첨부는 추측하지 않습니다

  노트가 없는 파일을 가리키거나 둘 이상의 항목과 일치하면 링크를 만들지 않고 이유를 기록합니다. 엉뚱한 파일이 조용히 붙는 일을 막기 위해서입니다.

자주 묻는 질문

더 깊이 읽기

• 8분 읽기Google Keep 메모를 Markdown으로 옮기는 법 (Takeout, 체크리스트, 라벨, 첨부파일)Keep에는 Markdown 내보내기가 없지만 Google Takeout은 모든 메모를 JSON으로 내줍니다. 그 데이터에 무엇이 들어 있고 각 필드가 Markdown 어디로 가는지, 빠진 것은 없는지 확인하는 방법을 설명합니다.