Obsidian은 링크를 [[회의록]] 같은 위키링크로 쓰고 이미지를 ![[diagram.png]]로 삽입합니다. 이는 표준 마크다운이 아니라서 볼트를 GitHub, Notion, 정적 사이트 생성기, 다른 에디터에 옮기면 겹대괄호가 그대로 보이고 이미지가 깨집니다. 이 Obsidian 마크다운 내보내기는 볼트 ZIP을 받아 지원되는 위키링크와 이미지 임베드를 이식 가능한 상대 링크로 다시 쓰고, 노트와 사용된 이미지를 패키징하며, 변환하지 못한 모든 것을 보고서에 나열합니다.
설계상 보수적입니다. 정확히 하나의 노트가 일치할 때만 링크를 해석하고, 이해하지 못하는 구문은 건드리지 않고 보고서에 알리며, 코드 블록, 프런트매터, 원시 HTML은 절대 수정하지 않습니다. 작업은 브라우저 안의 사본에서 이뤄지므로 원본 파일은 바뀌지 않습니다.
모든 처리는 브라우저 탭 안에서 확인, 압축 해제, 변환, 패키징 단계로 나뉘어 진행 막대와 함께 이뤄집니다. 제공한 ZIP은 서버로 전송되지 않습니다. 한도는 ZIP 20 MiB, 압축 해제 64 MiB, 항목당 8 MiB, 항목 20,000개, 출력 80 MiB입니다.
사용 방법
볼트의 내용물을 압축
볼트를 감싸는 Vault 폴더가 아니라 그 안의 파일과 폴더를 선택해 압축하세요. 볼트 루트가 ZIP의 루트여야
[[Guides/Plan]]같은 링크가 해석되고, 폴더가 하나 더 있으면 실패합니다.ZIP 선택
파일을 선택하거나, 처음 열 때 이미 열려 있는 샘플 볼트를 살펴보세요. UTF-8 마크다운 노트(.md, .markdown)와 PNG, JPEG, GIF, WebP 이미지만 사용됩니다.
노트 패키징
패키징을 실행하면 진행 막대가 확인, 압축 해제, 변환, 패키징 순서로 채워집니다. 끝나면 결과 대시보드에 변환된 노트, 링크가 바뀐 노트, 포함된 이미지, 검토할 문제, 제외된 파일이 카드로 나타납니다.
노트와 문제 검토
노트 목록은 검색할 수 있고 노트마다 링크 변경됨 또는 변경 없음 표시가 붙습니다. 노트를 선택하면 변환 전후 텍스트가 나란히 보입니다(앞 200,000자까지이며 전체 내용은 ZIP에 있습니다). 문제 표에는 이유 코드별 필터 칩이 있고 파일, 줄, 열, 원본 참조, 후보가 나옵니다. 입력 파일 목록과 출력 파일 목록은 펼쳐 볼 수 있습니다.
ZIP과 보고서 내려받기
obsidian-portable.zip(파일은 markdownport-export/ 아래에 들어 있습니다)과 obsidian-export-issues.json을 내려받습니다. 다른 곳에 가져오기 전에 압축을 풀어 일반 마크다운 리더로 몇 개 열어 보세요.
작동 원리
변환되는 것
위키링크와 임베드는 해당 노트를 기준으로 한 상대 경로의 CommonMark 링크 문법으로 다시 쓰입니다. 경로는 퍼센트 인코딩되므로 공백과 비ASCII 문자도 어떤 리더에서든 안전합니다. .markdown 파일은 .md로 이름이 바뀌고 이를 가리키는 링크도 따라갑니다.
경로가 없는 위키링크는 Obsidian처럼 대소문자를 무시하고 볼트 어디서든 파일 이름으로 해석합니다. 폴더 경로가 있는 링크는 볼트 루트부터 해석합니다. 파이프 뒤의 별칭은 링크 텍스트가 되고, 없으면 노트 파일 이름을 씁니다.
| Obsidian에서 | 내보내기에서 |
|---|---|
| [[Ideas]] | [Ideas](Ideas.md) |
| [[Guides/Plan|the plan]] | [the plan](Guides/Plan.md) |
| ![[images/pixel.png]] |  |
| 하위 폴더에서 [[My Page]] | [My Page](../My%20Page.md) |
| [x](O.markdown) | [x](O.md) |
일부러 건드리지 않는 것
프런트매터, 펜스 코드 블록과 들여쓰기 코드 블록, 인라인 코드, 원시 HTML, 역슬래시로 이스케이프된 \[[ 안의 내용은 절대 수정하지 않습니다. 표준 마크다운으로 표현할 수 없는 구문은 그대로 두고 보고서에 기록합니다. ![[Other]] 같은 노트 임베드, [[Note#^id]] 같은 블록 참조, > [!note] 같은 콜아웃 표시 줄(인용 본문의 링크는 변환), Dataview와 Templater 블록, <% %> 템플릿 태그, 인라인 = 쿼리, 이미지가 아닌 첨부 파일이 그렇습니다.
[[Note#Heading]] 같은 제목 링크도 목적지마다 제목 앵커 규칙이 달라서 이유 코드 target_dependent_anchor와 함께 그대로 둡니다.
보고서의 이유 코드
모든 문제에는 원본 경로, 유니코드 문자 기준 1부터 세는 줄과 열, 원문, 해당하는 경우 후보 목록이 있습니다. .obsidian 같은 숨김 파일과 쓰이지 않은 이미지는 excluded로 나열됩니다.
| 코드 | 의미 |
|---|---|
| missing | 그 이름의 노트나 이미지를 찾지 못함. 볼트 루트를 확인하세요 |
| ambiguous | 일치하는 파일이 여러 개. 경로로 링크를 한정하세요 |
| unsupported | 그대로 둔 구문: 블록 참조, 노트 임베드, 콜아웃 표시 줄, 플러그인 코드 |
| target_dependent_anchor | 그대로 둔 제목 링크 |
| external_unbundled | 내려받지 않은 웹 링크나 원격 이미지 |
| unsafe_reference | 볼트 밖으로 올라가거나 스킴을 쓰는 경로 |
| dimensions_discarded | |200 같은 이미지 크기를 버림 |
| excluded | 패키지에서 제외한 파일 |
| output_case_collision | 출력 이름 두 개가 대소문자만 다름 |
실제 예시
Start.md:
See [[Guides/Plan|the plan]] and [[Ideas]].
![[images/pixel.png]]
![[images/pixel.png|200]]
Guides/Plan.md:
# Plan
Back to [[Start]]Start.md:
See [the plan](Guides/Plan.md) and [Ideas](Ideas.md).
Guides/Plan.md:
# Plan
Back to [Start](../Start.md)
issues: dimensions_discarded at Start.md 4:1 for ![[images/pixel.png|200]]볼트에는 Ideas.md와 images/pixel.png도 있습니다. 패키지에는 노트 3개와 이미지 1개가 들어 있습니다.
A.md:
[[Todo]] [[Nope]] ![[Todo]] [[Todo#Goals]] [[Todo#^b1]]
> [!tip] Hi
one/Todo.md, two/Todo.mdA.md (unchanged):
[[Todo]] [[Nope]] ![[Todo]] [[Todo#Goals]] [[Todo#^b1]]
> [!tip] Hi
A.md 1:1 ambiguous [[Todo]] (one/Todo.md, two/Todo.md)
A.md 1:10 missing [[Nope]]
A.md 1:19 unsupported ![[Todo]]
A.md 1:29 target_dependent_anchor [[Todo#Goals]]
A.md 1:44 unsupported [[Todo#^b1]]
A.md 2:1 unsupported > [!tip] Hi여기서는 안전하게 변환할 수 있는 것이 없으므로 노트는 그대로 복사되고 모든 경우가 보고됩니다.
Daily Notes/2026-10-01.md:
[[My Page]] and [[회의록/주간 회의|주간 회의]]
My Page.md, 회의록/주간 회의.mdDaily Notes/2026-10-01.md:
[My Page](../My%20Page.md) and [주간 회의](../%ED%9A%8C%EC%9D%98%EB%A1%9D/%EC%A3%BC%EA%B0%84%20%ED%9A%8C%EC%9D%98.md)경로는 노트의 폴더를 기준으로 한 상대 경로이며 UTF-8로 퍼센트 인코딩되고 보고된 문제는 없습니다.
N.md:
---
link: "[[A]]"
---
[[A]]
`[[A]]`
```
[[A]]
```
A.mdN.md:
---
link: "[[A]]"
---
[A](A.md)
`[[A]]`
```
[[A]]
```본문 텍스트의 링크만 변환됩니다.
자주 하는 실수
압축하는 폴더 단계가 잘못됨
ZIP 맨 위에 Vault 폴더가 있으면
[[Guides/Plan]]링크는 ZIP 루트에서 Guides/Plan을 찾아 missing을 보고합니다. 실제 파일은 Vault/Guides/Plan.md에 있기 때문입니다. 볼트의 내용물을 압축하세요. 감싸는 폴더는 절대 제거되지 않습니다.노트 이름 중복
Obsidian은 자체 규칙으로 일치하는 것 하나를 고르지만 일반 마크다운 도구에는 그런 규칙이 없습니다. 노트 두 개가 이름을 공유하면 링크는 ambiguous로 보고되고 그대로 남습니다. Obsidian에서 [[projects/Todo]]처럼 폴더 경로로 한정한 뒤 다시 내보내세요.
이미지가 아닌 첨부 파일은 제외
PDF, 오디오, 비디오 등 다른 첨부는 패키징되지 않고 해당 링크는 unsupported 문제와 함께 위키링크로 남습니다. 노트가 실제로 참조하는 PNG, JPEG, GIF, WebP 이미지만 포함됩니다.
제목·블록 링크는 수작업 필요
#나 #^가 든 링크는 Notion, GitHub 등에서 앵커 이름이 달라서 그대로 둡니다. 가져온 뒤 그 몇 개의 링크를 대상에서 직접 고치세요.
대소문자를 구분하는 파일 시스템
Case.md와 case.md처럼 출력 파일 두 개가 대소문자만 다르면, 대소문자를 구분하지 않는 디스크(Windows, 기본 설정의 macOS)에 풀 때 한쪽이 덮어써질 수 있다고 경고합니다. 하나의 이름과 그 링크를 바꾸세요.
플러그인은 실행되지 않음
Dataview 쿼리, Templater 태그, 콜아웃은 텍스트로 복사됩니다. Obsidian 밖에서는 실행되거나 렌더링되지 않으므로 대상에서 교체할 각오를 하세요.
자주 묻는 질문
Obsidian 위키링크를 마크다운 링크로 바꾸려면?
볼트의 내용물을 압축해 ZIP을 여기에 불러와 패키징하세요. 지원되는 [[위키링크]]와 ![[이미지]] 임베드가 내려받는 ZIP 안에서 상대 표준 링크가 됩니다.
원본 볼트가 바뀌나요?
아니요. 받은 ZIP을 읽어 새 ZIP을 만들 뿐입니다. 볼트와 ZIP은 그대로입니다.
내보내기에는 어떤 파일이 들어가나요?
마크다운 노트(.md, .markdown은 .md로 이름 변경)와 이들이 참조하는 PNG, JPEG, GIF, WebP 이미지입니다. .obsidian 같은 숨김 파일과 쓰이지 않은 이미지는 제외됩니다.
해석하지 못한 링크는 어떻게 되나요?
쓰인 그대로 남고 파일, 줄, 열, 이유 코드와 함께 문제 보고서에 나열되므로 볼트에서 고친 뒤 다시 내보낼 수 있습니다.
결과가 Notion에 깔끔하게 가져와지나요?
표준 상대 링크와 이미지는 대체로 가져와지지만 앵커, 확장, 이미지의 Notion 처리 방식이 다를 수 있고 이 도구는 어떤 대상도 검증하지 않습니다. 먼저 사본을 가져와 결과를 검토하세요.
볼트가 업로드되나요?
아니요. 제공한 ZIP은 브라우저 안에서 처리되며 서버로 전송되지 않습니다. 문제 보고서에는 비공개 파일 이름과 참조가 들어 있으니 공유할 권한이 있는 노트만 공유하세요.
더 깊이 읽기
- 8분 읽기Google Keep 메모를 Markdown으로 옮기는 법 (Takeout, 체크리스트, 라벨, 첨부파일)Keep에는 Markdown 내보내기가 없지만 Google Takeout은 모든 메모를 JSON으로 내줍니다. 그 데이터에 무엇이 들어 있고 각 필드가 Markdown 어디로 가는지, 빠진 것은 없는지 확인하는 방법을 설명합니다.
- 8분 읽기노트를 내보내면 링크가 깨지는 이유와 Notion·Apple 메모·Obsidian 내보내기 복구법노트 내보내기는 폴더 트리와 그 안을 가리키는 텍스트의 묶음입니다. 이름이 바뀌거나 앱 고유의 링크 문법이 밖으로 나오면 모든 포인터를 다시 계산해야 하고, 결과는 몇 가지 숫자로 검증할 수 있습니다.
마지막 업데이트: