자료 옮기기임포트Obsidian마이그레이션markdown위키링크
Obsidian 볼트 가져오기
웹에서 바로 가져올 수 있습니다. Notion·Bear 등 일반 markdown 폴더도 같은 카드로 처리됩니다.
약 4분 2026년 8월 8일 업데이트
이 가이드에서 다루는 내용
볼트 압축하기
1
vault 폴더를 그대로 압축
Finder·탐색기에서 볼트 폴더를 우클릭 → 압축(.zip). 폴더 구조를 바꾸지 마세요 — 그 구조가 페이지 계층이 됩니다.
TIP
.obsidian 설정 폴더는 자동으로 제외되므로 따로 지울 필요가 없습니다.2
첨부 폴더도 포함
이미지·PDF 가 들어있는 첨부 폴더(보통 attachments/ 또는 assets/)를 함께 압축해야 본문 이미지가 살아납니다.
3
크기 확인
zip 1개 최대 50MB. 큰 볼트는 상위 폴더 단위로 나눠 여러 번 올리세요.
주의가져오기는 되돌릴 수 없습니다. 먼저 작은 폴더로 한 번 시험해보는 것을 권합니다.
Tabple 로 가져오기
1
설정 → 데이터 가져오기
/settings/import 진입 → 대상 프로젝트 선택 → 'Obsidian · 일반 markdown' 카드에 .zip 드롭.
2
결과 확인
imported = 만든 페이지 수, attachmentsUploaded = 업로드된 첨부 수. errors 에 건너뛴 항목과 이유가 표시됩니다.
변환 규칙
- 폴더 = 페이지 계층.
Vault/Projects/Alpha.md→Vault→Projects→Alpha Alpha.md와 같은 이름의 동위 폴더Alpha/가 있으면 그 폴더 내용이 Alpha 의 자식이 됩니다 (Obsidian 폴더 노트 관례 — 데스크탑 앱과 동일)[[노트]]·[[폴더/노트]]·[[노트#헤딩]]·[[노트|표시 이름]]→ 모두 제목으로 매칭해 페이지 멘션으로 연결. 같은 볼트 안에 대상이 없으면 텍스트로 남습니다![[첨부.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가이드 참고