자료 옮기기임포트Obsidian마이그레이션markdown위키링크

Obsidian 볼트 가져오기

웹에서 바로 가져올 수 있습니다. Notion·Bear 등 일반 markdown 폴더도 같은 카드로 처리됩니다.

약 4분 2026년 10월 13일 업데이트

볼트 압축하기

Finder·탐색기에서 볼트 폴더를 우클릭 → 압축(.zip). 폴더 구조를 바꾸지 마세요 — 그 구조가 페이지 계층이 됩니다.

TIP.obsidian 설정 폴더는 자동으로 제외되므로 따로 지울 필요가 없습니다.

이미지·PDF 가 들어있는 첨부 폴더(보통 attachments/ 또는 assets/)를 함께 압축해야 본문 이미지가 살아납니다.

zip 1개 최대 50MB. 큰 볼트는 상위 폴더 단위로 나눠 여러 번 올리세요.

주의가져오기는 되돌릴 수 없습니다. 먼저 작은 폴더로 한 번 시험해보는 것을 권합니다.

설정 → 백업의 '가져오기 화면 열기' (또는 /settings/import로 직접 진입) → 대상 프로젝트 선택 → 'Obsidian · 일반 markdown' 카드에 .zip 드롭.

카드에 '완료: N개 페이지'(만든 페이지 수), '건너뜀 N건 / 오류 N건', '첨부 업로드 N개'가 표시됩니다. 오류가 있으면 '에러 보기'에 건너뛴 항목과 이유가 나옵니다.

폴더 = 페이지 계층. Vault/Projects/Alpha.md → Vault → Projects → Alpha
Alpha.md 와 같은 이름의 동위 폴더 Alpha/ 가 있으면 그 폴더 내용이 Alpha 의 자식이 됩니다 (Obsidian 폴더 노트 관례 — 데스크탑 앱과 동일)
[[노트]] · [[폴더/노트]] · [[노트#헤딩]] · [[노트|표시 이름]] → 모두 제목으로 매칭해 페이지 멘션으로 연결. 같은 볼트 안에 대상이 없으면 텍스트로 남습니다
![[첨부.png]] 임베드와 ![](../assets/그림.png) 상대경로 모두 첨부로 업로드 후 인라인 이미지로 치환 (한글·공백 파일명 포함)
YAML frontmatter 의 tags: → 본문 최상단 #tag 문단으로 보존, title: 이 있으면 페이지 제목으로 사용. frontmatter 원문은 본문에 남지 않습니다
파일의 수정 시각 → 페이지 생성·수정 시각으로 보존
표·코드 블록·체크리스트·인용은 그대로 변환되며, 코드 블록 안의 [[...]] 은 치환하지 않습니다 (명령어 예시 보존)
> [!note] 제목 콜아웃 → 콜아웃 블록 (note·tip·warning·success·danger 등을 4종으로 매핑), ==강조== → 형광펜, %%숨김 주석%% → 숨김 주석, $수식$ ·$$블록 수식$$ → KaTeX 수식 블록
코드 블록·인라인 코드 안의 $·==·%% 는 변환하지 않습니다 — 명령어·코드 예시가 수식이나 강조로 바뀌지 않습니다

위키 페이지 트리는 4단계까지입니다. 더 깊은 볼트는 노트를 버리지 않고 허용 깊이의 마지막 폴더에 붙입니다 — 계층 일부만 평평해지고 본문은 모두 들어옵니다
첨부는 이미지와 PDF 만 가져옵니다 (magic-byte 화이트리스트). 첨부 1개가 25MB 를 넘으면 건너뜁니다
가져온 첨부는 계정의 누적 저장 용량에 포함됩니다. 한도가 찬 상태에서는 가져오기가 413 으로 거부됩니다
Dataview·Templater 등 플러그인 전용 블록은 코드/텍스트로 들어옵니다 (플러그인 실행 결과가 아니라 원문 그대로)
데스크탑 앱을 쓰면 압축 없이 볼트 폴더를 양방향 동기화할 수도 있습니다 — vault-sync 가이드 참고
가져오기는 1분에 3번 · 1시간에 15번 · 하루에 50번까지 보낼 수 있습니다. 한도를 넘으면 안내된 시간 뒤에 다시 시도하세요.
위키 페이지 수는 프로젝트 소유자의 요금제 한도(Free 100개 · 유료 플랜은 제한 없음) 안에서만 늘릴 수 있습니다. 가져올 노트가 남은 한도보다 많으면 가져오기가 거절됩니다.

이 가이드가 도움이 되었나요?