노션에서 워크스페이스를 마크다운·CSV로 내보내면 모든 페이지와 폴더 이름이 프로젝트 계획 3b1f0c2d9a4e4f56a7c8d9e0f1a2b3c4.md처럼 뒤에 긴 ID가 붙고, 페이지 사이 링크는 그 ID가 들어간 퍼센트 인코딩 경로이며, 이미지는 페이지별 폴더에 흩어져 있습니다. 이 폴더를 옵시디언이나 Git 저장소, 정적 사이트 생성기에 그대로 옮기면 이름을 알아볼 수 없고, 일부 링크는 이름이 바뀐 파일을 가리키며, 이미지도 사라집니다. Notion 내보내기 복구기는 내보내기 ZIP을 브라우저에서 읽어 ID 접미사를 지우고 새 이름에 맞게 내부 링크를 다시 쓰며 첨부 파일을 한 폴더에 모읍니다.
노션을 떠나는 사람, 워크스페이스를 보관하려는 사람, 내보내기 파일로 문서 사이트를 만들려는 사람을 위한 도구입니다. 정리된 마크다운과 CSV 외에 오프라인에서 훑어볼 수 있는 html/index.html, 해결하지 못한 링크를 모두 적은 VAULTMEND-REPORT.json, 출력 파일마다 SHA-256을 담은 VAULTMEND-MANIFEST.json을 함께 만들어 나중에 보관본을 검증할 수 있습니다. 업로드는 없고 ZIP은 브라우저 메모리에서만 처리됩니다.
사용 방법
노션에서 마크다운·CSV로 내보내기
노션 내보내기 창에서 Markdown & CSV 형식을 고르고, 계층 구조가 필요하면 하위 페이지도 포함하세요. 내려받은 ZIP은 수정하지 말고 원본 백업으로 보관합니다.
ZIP 열기
.zip을 페이지에 끌어다 놓습니다. 용량은 512MB 이하여야 하며, 바로 안쪽이나 노션 Part ZIP 안에 .md 파일이 하나 이상 있어야 합니다. 찾은 페이지와 데이터베이스가 목록으로 나옵니다.
복구 보고서 확인
보고서에 읽은 파일, 이름이 바뀐 파일, 고친 링크, 다시 연결한 이미지, 해결하지 못한 항목의 수가 나옵니다. 페이지를 열면 복구 전후 본문이 나란히 보이고 다시 쓴 링크 대상이 강조됩니다. 목록을 ‘해결 못 함’으로 바꾸면 손볼 것만 모아 볼 수 있습니다.
남길 항목 선택
처음에는 모든 페이지와 데이터베이스가 선택되어 있습니다. 결과에 넣고 싶지 않은 것은 체크를 풀어 주세요.
이식 가능한 보관 폴더 내려받기
‘복구한 ZIP 내려받기’ 버튼은
vault/(정리된 페이지, CSV,_attachments/),html/index.html, 복구 보고서, SHA-256 매니페스트가 모두 든 ZIP 하나를 만듭니다. HTML, JSON, 첨부 파일만 담은 ZIP도 받을 수 있습니다.남은 문제는 보고서로 확인
VAULTMEND-REPORT.json에서 해결하지 못한 링크, 이름이 바뀐 파일 수, 첨부 파일 수를 확인하세요. 직접 고치거나 하위 페이지를 포함해 다시 내보내면 됩니다.
작동 원리
ID는 어디서 오고 어떻게 지우나요
노션은 제목이 같은 페이지가 충돌하지 않도록 내보내는 모든 이름 끝에 페이지 고유 ID를 붙입니다. ID는 16진수 32자이거나 8-4-4-4-12 형태의 하이픈 UUID이고, 앞에 공백이 하나 있으며 확장자 바로 앞에 놓입니다. 복구기는 모든 경로의 모든 구간에서 이 접미사를 지우므로 파일명뿐 아니라 폴더명도 정리됩니다.
이름은 파일 시스템에서 안전하게 바뀌기도 합니다. < > : " / \ | ? * 와 제어 문자는 공백이 되고, 연속 공백은 하나로 줄며, 이름은 120자까지로 잘립니다. 정리한 이름이 겹치면 두 번째는 (2), 세 번째는 (3)이 붙습니다. 목록의 페이지 제목은 코드 펜스 바깥에 있는 첫 # 제목에서 가져오고, 없으면 정리된 파일명을 씁니다.
Projects 2222...2222/Plan 3333...3333.md -> Projects/Plan.md
Plan 4444...4444.md and Plan 5555...5555.md -> Plan.md and Plan (2).md링크를 찾아 다시 쓰는 방법
[이름](대상)과  형태의 마크다운 링크와 이미지를 모두 검사합니다. mailto:, data:, # 로 시작하는 링크는 그대로 두고 http(s) 링크도 그대로 두지만, 내보내기 안에 있는 페이지 ID를 담은 notion.so나 notion.site 링크만은 내보낸 페이지의 상대 경로로 바꿉니다. 로컬 대상은 먼저 대상 안의 ID로 찾고, 다음에 현재 파일 기준으로 경로를 풀어 보고, 마지막으로 압축 파일 전체에서 유일한 파일명으로 찾습니다.
찾은 대상은 현재 파일의 새 위치에서 본 상대 경로로, URL 인코딩해서 다시 씁니다. 첨부 파일은 페이지별 폴더에 두지 않고 하나의 _attachments/ 폴더로 복사하며 이름이 겹치면 역시 접미사가 붙습니다. 어디에도 맞지 않은 링크는 손대지 않고 보고서에 남겨 무엇이 빠졌는지 정확히 알 수 있게 합니다.
| 내보내기 안의 링크 대상 | 결과 |
|---|---|
| Projects%2022222222222222222222222222222222/Plan%2033333333333333333333333333333333.md | Projects/Plan.md |
| Home%2011111111111111111111111111111111/Board.png | _attachments/Board.png |
| https://www.notion.so/help/export-your-content | 변경 없음 |
| Home%2011111111111111111111111111111111/Missing.pdf(ZIP에 없음) | 변경 없이 해결 못 한 링크로 기록 |
CSV 데이터베이스와 오프라인 HTML 색인
데이터베이스는 CSV로 내보내집니다. 복구기는 따옴표 규칙에 맞춰 CSV를 읽고, 내보낸 페이지·데이터베이스와 실제로 일치하는 Files & media 첨부 파일을 새 상대 경로로 바꾼 뒤 CRLF 줄바꿈과 표준 큰따옴표 이스케이프로 다시 저장합니다. Title (https://www.notion.so/...-<page ID>) 형태의 관계형도 그 페이지가 ZIP에 있으면 다시 연결합니다. 노션이 빼놓은 롤업·보기·속성은 복원하지 못합니다.
html/index.html에는 전체 파일 사이드바, 페이지·데이터베이스·복구한 링크·해결 못 한 링크 수가 있고 CSV 데이터베이스는 표로 보입니다. 마크다운 렌더러는 일부러 작게 만들어 제목, 링크, 이미지, 줄바꿈만 처리합니다. 진짜 결과물은 vault/ 안의 마크다운이고 HTML은 참고용 보기입니다.
실제 예시
Home 1111...1111.md에 [Plan](Projects%2022...22/Plan%2033...33.md)와 가 들어 있음Home.md에 [Plan](Projects/Plan.md)와 가 들어감두 링크 모두 복구한 것으로 세고, Board.png는 vault/_attachments/Board.png로 복사됩니다.
최상위에 Plan 4444...4444.md와 Plan 5555...5555.mdPlan.md와 Plan (2).md덮어쓰는 일은 없습니다. 두 페이지 모두 내용을 유지하고 색인에도 따로 나옵니다.
Projects 2222...2222.csv에서 한 행의 Pages 셀이 Plan 3333...3333.md, Research 4444...4444.mdProjects/Projects.csv에서 그 셀이 Plan.md, Research.md셀 안의 파일을 하나씩 따로 찾으므로 복구한 링크 2개로 세고, CSV는 CRLF 줄바꿈으로 다시 저장됩니다.
[Missing](Home%2011...11/Missing.pdf)원문 그대로 남고 VAULTMEND-REPORT.json에 {source: "Home 1111...1111.md", link: "Home%2011...11/Missing.pdf"}로 기록됨페이지 자체는 보관 폴더에 그대로 남고 이 링크만 표시되므로, 일부만 내보낸 경우에도 결과를 쓸 수 있습니다.
Folder 1111...1111\Page 2222...2222.mdFolder/Page.md이름을 정리하기 전에 백슬래시를 슬래시로 통일합니다.
자주 하는 실수
하위 페이지를 포함해 내보내지 않으면 링크가 해결되지 않습니다
하위 페이지 없이 내보내면 그 페이지로 가는 링크가 가리킬 파일이 없습니다. 링크는 그대로 남아 해결 못 한 목록에 오르니 하위 페이지를 포함해 다시 내보내세요.
CSV에서 쉼표는 확장자 바로 뒤에서만 셀을 나눕니다
A.md, B.md셀은 참조 두 개로 읽어 각각 고칩니다.Plan, final.md처럼 이름 안에 쉼표가 있으면 쉼표가 확장자 바로 뒤가 아니므로 이름 하나로 남습니다. 지원하는 확장자로 끝나지 않는 셀 속 글은 건드리지 않고, 어디에도 맞지 않는 파일은 해결 못 한 항목으로 기록하되 같은 셀의 나머지는 그대로 고칩니다.관계형, 롤업, 서식은 만들어 내지 않습니다
Title (https://www.notion.so/...-<page ID>)형태로 내보낸 관계형은 해당 페이지가 있으면 다시 연결합니다. 그 밖의 일반 텍스트로 바뀐 관계형은 텍스트로 남고, ZIP에 없는 데이터베이스 보기나 속성은 다시 만들지 않습니다.HTML 색인은 단순화된 보기입니다
목록, 굵은 글씨, 마크다운 표, 코드 블록은 입력한 글자 그대로 줄바꿈과 함께 나옵니다. 서식을 정확히 보려면 마크다운 파일을 쓰거나 직접 렌더러를 쓰세요.
첨부 파일은 한 폴더로 펼쳐집니다
마크다운과 CSV가 아닌 파일은 모두
_attachments/로 갑니다. 링크는 갱신되지만 다른 도구에서 그 파일을 참조한다면 폴더 구조가 노션과 달라집니다.
자주 묻는 질문
노션 내보내기 파일명의 긴 ID를 지우려면 어떻게 하나요?
복구기에 내보내기 ZIP을 열고 이식 가능한 보관 폴더를 내려받으면 됩니다. 32자리(또는 하이픈 UUID) 접미사가 모든 파일과 폴더 이름에서 사라지고, 예전 이름을 가리키던 링크도 다시 쓰입니다.
어떤 노션 내보내기 형식을 지원하나요?
ZIP으로 받는 Markdown & CSV 내보내기입니다. 큰 내보내기는 노션 Part ZIP이 든 바깥 ZIP도 열 수 있습니다. 바로 안쪽이나 중첩 ZIP에 .md 파일이 하나 이상 있어야 하며 HTML 형식은 지원하지 않습니다.
내 워크스페이스가 업로드되나요?
아니요. ZIP은 브라우저 안에서 읽고 다시 만들며 서버로 전송하지 않습니다.
결과물을 옵시디언에서 쓸 수 있나요?
vault/ 폴더는 평범한 상대 경로 마크다운 링크와 평평한 _attachments 폴더로 되어 있어 옵시디언 보관함으로 열 수 있습니다. 데이터베이스 보기 같은 노션 전용 기능은 마크다운에 포함되지 않습니다.
매니페스트는 무엇에 쓰나요?
VAULTMEND-MANIFEST.json은 생성된 모든 파일의 크기와 SHA-256 해시를 적어 둡니다. 보관본과 함께 두면 나중에 파일이 바뀌지 않았음을 확인할 수 있습니다.
제목이 같은 페이지가 있으면 어떻게 되나요?
두 번째 파일은 확장자 앞에 (2), 세 번째는 (3)처럼 번호가 붙습니다. 링크는 먼저 페이지 ID로 찾기 때문에 각 링크는 여전히 올바른 페이지를 가리킵니다.
ZIP은 얼마나 커도 되나요?
512MB를 넘는 ZIP은 거절합니다. 실제 한계는 기기 메모리와 브라우저에 따라서도 달라집니다.
더 깊이 읽기
마지막 업데이트: