마크다운 파일은 이미지 데이터를 직접 담지 않은 채 이미지를 가리킬 수 있습니다. 그래서 텍스트 파일만 복사하면 글이야 잘 읽히지만, 그림이 있어야 할 자리가 비어 있는 문서가 만들어집니다.
PDF Craft는 마크다운 결과를 ZIP 압축 파일로 내려받게 합니다. 마크다운 문서를 편집하거나 옮기기 전에 압축 파일을 온전히 풀어 두세요. ZIP 안에서 미리보기만 열면 함께 들어 있는 이미지와의 관계를 놓치기 쉽습니다.
문서와 딸린 파일 파악하기
완료된 PDF-마크다운 변환 작업에서 ZIP 파일을 내려받아 전용 폴더에 풉니다. 압축 파일에는 마크다운 문서가 들어 있고, 이미지 리소스가 생성된 경우에는 그 이미지들이 담긴 폴더도 함께 들어 있습니다. 내보내기 이름은 경우에 따라 다를 수 있습니다. 문서 이름이 원본 파일 이름을 따를 수도 있고 document.md처럼 붙을 수도 있으며, 리소스는 images/나 assets/ 아래에 있을 수 있습니다. .md 파일을 텍스트 편집기로 열어 예시에 맞춰 폴더 이름을 바꾸기보다 실제 링크를 그대로 따라가세요. 원본 ZIP 파일은 손대지 않은 사본으로 남겨 둡니다.
링크는 상대 경로 파일을 가리킬 수도 있고, 로컬 절대 경로나 원격 URL을 가리킬 수도 있습니다. 이 형식들은 각각 옮길 수 있는 범위가 다릅니다. 상대 경로 파일은 옆에 있는 리소스를 함께 보존해야 하고, 원격 URL은 네트워크에 접속할 수 있어야 하며 해당 주소에서 계속 제공되어야 합니다.
캡션과 그림 번호가 문서 안의 텍스트인지, 아니면 그림 자체에 포함되어 있는지도 확인하세요. 이미지를 보관한다고 해서 그 안의 모든 글자가 인식되거나 번역되었다고 볼 수는 없습니다. 이런 내용의 관계는 이미지와 캡션 검토 가이드에서 다룹니다.
마크다운 파일 위치를 기준으로 상대 경로 읽기
핵심은 마크다운 파일이 리소스 폴더 바로 옆에 있다는 관계입니다. 아래는 문서 이름과 이미지 이름을 임의로 넣은 단순한 예시이니, 내려받은 파일에서 실제 이름을 확인하세요.
paper/
├── notes.md
└── images/
└── figure-1.png
이에 대응하는 마크다운은 다음과 같을 수 있습니다.
편집기는 notes.md를 기준으로 images/figure-1.png를 찾습니다. paper 폴더 전체를 옮기면 이 관계가 그대로 유지됩니다. notes.md만 옮기면 링크가 기대하는 위치에 이미지가 없을 수 있습니다.
파일 이름의 대소문자, 공백, 확장자, 인코딩된 문자는 시스템에 따라 문제를 일으킬 수 있습니다. 한 컴퓨터에서는 보이던 이미지도 실제 파일 이름과 링크에 적힌 이름이 다르면 다른 곳으로 옮긴 뒤 열리지 않을 수 있습니다.
작업 폴더 전체를 옮기기
내려받은 원본은 그대로 두세요. 마크다운과 그것이 사용하는 모든 로컬 리소스를 담은 작업 사본을 만들고, 우선 기존 구조를 유지합니다. 원래 배치대로 열리는 것을 확인한 다음에 정리하세요.
리소스 폴더 이름을 바꿨다면 해당 링크를 고치고 그림 여러 개를 시험해 보세요. 여러 문서에서 가져온 파일을 한 폴더에 모을 때는 이름이 겹치지 않도록 먼저 이름 규칙을 정하세요. 서로 다른 image1.png 두 개가 덮어써지거나 헷갈릴 수 있습니다.
노트 앱으로 가져올 때는 첨부 파일을 복사하는지, 아니면 원래 위치를 링크로만 연결하는지 확인하세요. Obsidian 가져오기 가이드에서는 외부 도구를 쓰는 방법 하나를 설명합니다. PDF Craft의 내보내기가 볼트 자동 동기화나 이미지 영구 호스팅을 뜻하는 것은 아닙니다.
미리보기가 아니라 파일을 공유하기
다른 사람이 다른 위치에서도 사용할 수 있는 로컬 사본을 필요로 한다면 문서와 필요한 리소스를 함께 전달하세요. 예를 들어 파일 관리자로 폴더를 압축해 보내면 됩니다. 공유한 사본은 내 컴퓨터에 남아 있는 경로에 기대지 말고, 다른 위치에서 열어 시험해 보세요.
마크다운을 웹사이트에 올린다면 그 사이트의 리소스 업로드 방식과 URL 규칙을 따르세요. 내 기기를 가리키는 file:/// 경로로는 원격 독자가 이미지에 접근할 수 없습니다. 깨진 미리보기를 고치겠다고 비공개 원본 그림을 공개 호스트에 올리지 마세요.
문서와 삽화를 공유할 권한이 있는지 확인하세요. 변환된 이미지도 원본 저작물의 일부이며, 변환했다고 해서 자유롭게 재사용할 수 있는 새 자료가 되는 것은 아닙니다.
깨진 이미지를 정해진 순서로 진단하기
- 마크다운 원본에서 링크를 읽습니다.
- 링크가 로컬 파일을 가리키는지 원격 URL을 가리키는지 확인합니다.
- 해당 파일이 예상 경로에 있는지, 또는 원격 주소에 접속할 수 있는지 확인합니다.
- 파일 이름, 대소문자, 확장자를 비교합니다.
- 이미지 파일 자체를 열어 불완전하거나 지원되지 않는 파일이 아닌지 확인합니다.
- 사용하려는 뷰어에서 마크다운을 다시 열고 캡션과 주변 내용을 살핍니다.
내려받은 파일에 리소스가 없다면 원본 PDF와 대조해 누락을 기록하세요. 기술 도면을 생성형 도구로 만든 비슷한 그림으로 대체하지 마세요. 빠진 내용을 해결하는 동안에는 원본 페이지를 가리키는 표시를 분명히 남겨 둡니다.
경로가 제대로 작동하면 연구 노트와 함께 원본 제목, 판본, 그림 위치를 보존하세요. 어디로 옮겨도 쓸 수 있는 문서가 되려면 링크가 제대로 작동해야 하고, 이미지가 어디서 왔는지 확인할 방법도 있어야 합니다.