Markdown 노트의 그림이 사라졌다면 경로부터 대조하세요

노트와 그림 두 파일로 상대 경로와 폴더 묶음 이동을 확인하는 연습.

Egorae 운영팀 · 수정 2026-10-20

Markdown 노트의 글은 보이는데 그림만 안 나온다면 노트 안의 이미지 주소와 실제 그림 위치를 따로 확인하세요. .md 파일 하나를 옮겼다고 그 파일이 참조하는 그림까지 함께 이동한 것은 아닙니다. 이 글은 같은 폴더 묶음의 상대 경로를 확인하는 연습이며, 모든 노트 앱의 첨부 관리 방식을 설명하지 않습니다.

두 파일로 정상 묶음 만들기

연습 자료는 note.md 받기와 route.svg 받기입니다. 둘 다 Egorae 자작 예제이며 그림은 실제 장소의 안내도가 아닙니다. 브라우저에서 내용이 표시되면 파일 저장을 이용하세요. 그림은 원과 네모를 선으로 연결한 단순 SVG입니다.

기기에 새 연습 폴더를 만든 뒤 note.md를 그 안에, route.svg를 그 아래 images 폴더 안에 둡니다. 두 파일을 다운로드 폴더에 나란히 둔 상태와 아래 구조는 다릅니다.

• 노트: practice/note.md
• 그림: practice/images/route.svg

note.md를 텍스트로 열면 이미지 문장은 ![설명](images/route.svg) 형태입니다. !로 시작하는 이미지 표기는 CommonMark에 정의되어 있습니다. 괄호 안은 그림 자체가 아니라 위치를 가리키는 대상입니다. CommonMark 이미지 문법.

원본 문법과 미리보기 화면 구분하기

텍스트 편집기에서 이미지 문장이 그대로 보이는 것은 파일이 깨졌다는 뜻이 아닙니다. Markdown을 렌더링하는 미리보기 기능이 있어야 이미지 표시 결과를 볼 수 있습니다. 사용 중인 도구가 SVG나 로컬 이미지를 제한할 수도 있으므로, 그림이 안 보인다는 결과만으로 파일이 없다고 확정하지 않습니다.

이 예제의 경로를 note.md가 있는 폴더 기준으로 읽으면 images 안의 route.svg입니다. 웹에 HTML로 변환해 올렸다면 생성된 페이지의 기준 주소와 렌더러의 처리 방식도 확인해야 합니다. URI의 상대 참조는 기준 URI에 따라 해석됩니다. 같은 글자라도 기준 위치가 달라지면 대상이 달라질 수 있습니다. RFC 3986의 참조 해석.

이동 방법 세 가지 비교

원본은 그대로 두고 연습용 복사본으로 비교합니다. 자신의 실제 노트를 옮기거나 지우기 전에 이 작은 묶음으로 확인하세요.

마지막 경우는 그림 파일이 없어진 것이 아니라 찾으라고 적힌 곳에 없는 상태입니다. note.md의 경로를 임의의 웹 주소로 바꾸기 전에, images 폴더 구조를 유지해 다시 배치할 수 있는지 확인합니다. 전체 묶음을 옮기는 방법과 경로를 고치는 방법 중 무엇을 택했는지 기록하세요.

Egorae는 2026-10-20 제공 note.md를 Python Markdown으로 해석한 이미지 대상이 images/route.svg인지 검사했습니다. 전체 묶음을 임시 폴더로 복사하면 대상 파일이 존재하고, note.md만 복사한 별도 폴더에서는 존재하지 않는 것도 대조했습니다. 이는 예제의 경로·파일 검사이며 특정 노트 앱의 화면이나 모든 운영체제에서 SVG가 표시된다는 보장은 아닙니다.

그림 파일이 있는데도 안 보일 때

다음 순서로 한 항목씩 구분합니다.

1. note.md에 적힌 경로와 폴더·파일 이름을 문자 그대로 대조합니다. 확장자나 대소문자가 달라지지 않았는지 확인합니다. 환경마다 같은 방식으로 취급한다고 가정하지 않습니다.
2. 실제 대상 파일을 별도로 열어봅니다. 대상이 디렉터리인지, 비어 있는 파일인지, 예상한 그림인지 확인합니다.
3. 미리보기 도구가 해당 형식과 로컬 파일 참조를 지원하는지 공식 안내에서 확인합니다. 보안 차단을 해제하거나 알 수 없는 플러그인을 설치하는 단계로 바로 넘어가지 않습니다.
4. 웹 주소를 참조한다면 로그인·접근 권한·네트워크에 의존하는지도 구분합니다. 화면에 보인다고 독립된 사본이 생긴 것은 아닙니다.

자신의 컴퓨터 절대 경로를 붙여 문제를 가리는 것도 피하세요. 내 기기에서는 보여도 다른 위치의 복사본이나 받는 사람에게 같은 경로가 없을 수 있습니다. 반대로 앱이 내부 첨부 ID를 쓰는 경우라면 이 상대 경로 연습을 그대로 적용하지 말고 해당 내보내기 형식을 먼저 확인합니다.

공유할 묶음의 완료 기준

이 예제에서는 새 폴더 안의 note.md에서 읽은 이미지 대상 파일이 실제로 존재하고, 지원되는 미리보기에서 예상한 그림을 확인했을 때 그 묶음의 점검을 마칠 수 있습니다. 실제로 확인하지 않은 단계는 기록에 남깁니다.

노트 파일 / 옮긴 폴더:
본문에 적힌 이미지 대상:
실제 대상 파일 위치 / 존재 여부:
대상 파일을 별도로 열어본 결과:
사용한 미리보기 / 형식 지원 확인:
이동 방법: 묶음 유지 / 경로 수정 / 앱 전용 내보내기
다른 위치에서 재확인한 범위 / 남은 문제:

여러 기록의 본문·첨부·링크를 함께 대조할 때는 백업 대조표 작성기를 사용할 수 있습니다. 최종 전달 형식이 PDF라면 저장된 PDF 점검으로 넘어가 실제 파일 안에 그림이 포함됐는지 별도 확인하세요. Markdown에서 그림이 보인다는 결과와 전달 파일의 완성 여부는 같은 검사가 아닙니다.