폴더를 이동한 후에도 마크다운 일기 이미지가 깨지지 않게 유지하는 방법

상대 이미지 경로의 의미

마크다운 이미지 문법은 느낌표, 대괄호 안의 대체 텍스트(alt text), 소괄호 안의 이미지 경로로 구성됩니다. 예를 들어 는 마크다운 파일을 기준으로 한 상대적 위치를 설명하여 이미지를 가리킵니다. CommonMark 사양은 train.jpg와 같은 이미지 경로 대상을 설명하며, Markdown Guide에서도 동일한 기본 문법을 안내합니다. CommonMark: Images Markdown Guide: Basic Syntax

상대 경로는 컴퓨터 내 특정 위치를 고정하는 것이 아니라 파일 간의 관계를 나타내므로 일기 폴더를 이동할 때 유용합니다. 노트와 이미지가 해당 관계를 유지한 채 함께 이동하면 경로는 여전히 동일한 이미지를 가리킵니다. /Users/sam/Pictures/blue-mug.jpg 또는 C:\\Users\\Sam\\Pictures\\blue-mug.jpg와 같은 절대 경로는 특정 기기의 위치를 지정하므로 일기를 다른 드라이브나 컴퓨터로 복사하면 링크가 유효하지 않게 될 수 있습니다.

함께 이동할 수 있는 폴더 구조 선택하기

연도별로 정리된 일기 노트의 경우, 연도별 폴더 옆에 공용 이미지 폴더를 두는 것이 실용적인 구조 중 하나입니다:

text Diary/ ├── images/ │ ├── blue-mug.jpg │ └── garden-bed.png ├── 2025/ │ └── 2025-04-12.md └── 2026/ └── 2026-09-30.md

Diary/2026/2026-09-30.md에서 blue-mug.jpg로 가는 경로는 ../images/blue-mug.jpg입니다. 즉, 2026 폴더에서 상위 디렉터리로 한 단계 올라간 다음 images 폴더로 들어갑니다. 마크다운 코드는 다음과 같이 작성할 수 있습니다:

md 

각 연도의 이미지가 해당 연도에만 속한다면 인접한 하위 폴더를 사용하는 방식도 직관적이고 이해하기 쉽습니다:

text Diary/ ├── 2026/ │ ├── images/ │ │ └── garden-bed.png │ └── 2026-09-30.md

이 경우 노트에서  구문을 사용할 수 있습니다. 이러한 예시는 표시되는 노트의 위치에 따라 달라집니다. 노트와 이미지 사이의 디렉터리 단계를 직접 계산하고, ../의 개수를 어림짐작하지 마세요.

노트의 관점에서 링크 작성하기

마크다운 파일이 있는 폴더에서 시작하여 이미지까지 디렉터리 트리를 따라 이동하세요. photo.jpg처럼 파일 이름만 있는 경로는 이미지가 노트와 같은 위치에 있음을 의미합니다. images/photo.jpg는 노트 옆의 images 하위 폴더에 있음을 나타냅니다. ../images/photo.jpg는 먼저 한 단계 상위로 올라가야 함을 뜻합니다. 이 규칙을 활용하면 뷰어에서 테스트해 보기 전에 링크를 명확하게 계산할 수 있습니다.

가능하면 파일 이름을 단순하게 유지하세요(예: 2026-09-30-garden.jpg). 여러 파일 시스템에서는 정확한 철자와 대소문자 구분이 중요하며, 오타나 대소문자 불일치만으로도 이미지가 표시되지 않을 수 있습니다. 공백과 문장 부호 또한 마크다운 애플리케이션마다 다르게 처리될 수 있습니다. Markdown Guide에서는 애플리케이션마다 URL의 공백 처리 방식이 다를 수 있음을 지적하며 호환성을 위해 %20 사용을 권장합니다. 이미지 이름에 공백이 포함되어 있다면 파일 이름을 단순하게 변경하는 것이 안전하며, 그렇지 않다면 사용 중인 뷰어에서 지원하는 인코딩이나 따옴표 스타일을 적용하고 제대로 작동하는지 확인하세요. Markdown Guide: Link Best Practices

내부 구조를 유지한 채 일기 이동하기

일기 폴더를 하나의 단위로 취급하세요. 노트만 옮기거나 이미지를 남겨두지 말고, .md 노트와 이미지가 모두 포함된 상위 Diary/ 폴더 전체를 복사하거나 이동하세요. 상대 경로는 폴더의 외부 위치가 변경되어도 내부 출발지와 목적지 사이의 관계가 그대로 유지되므로 계속 작동합니다.

일기 내부의 폴더를 재구성할 때는 영향을 받는 노트의 링크를 다시 계산해야 합니다. 예를 들어, 노트를 Diary/2026/에서 Diary/2026/trips/로 이동하면 Diary/images/에 도달하기 위한 경로가 변경되어 ../../images/blue-mug.jpg가 필요합니다. 상대 링크는 전체 트리 구조의 이동은 지원하지만, 트리의 일부만 재배치되는 것까지 자동으로 보정하지는 못합니다.

사용 중인 뷰어에서 실제 이동 테스트하기

새로운 폴더 구조에 의존하기 전에 간단하고 되돌릴 수 있는 점검 과정을 거치세요:

로컬 이미지가 하나 이상 포함된 노트를 선택하고, 평소 사용하는 마크다운 뷰어에서 이미지가 정상적으로 표시되는지 확인합니다.

일기 폴더 전체를 다른 일반 폴더나 이동식 드라이브 등 다른 위치로 복사합니다. 모든 하위 폴더와 파일 이름을 그대로 유지하세요.

동일한 뷰어에서 새 위치에 있는 복사된 노트를 엽니다. 단순히 마크다운 소스에 예상한 텍스트가 있는 것에 그치지 않고 이미지가 실제로 나타나는지 확인합니다.

서로 다른 깊이에 있는 노트를 열어 한두 개의 이미지를 확인하고, 특히 ../를 사용하는 노트를 확인하세요. 이렇게 하면 단순히 같은 폴더 내에 있는 예시 외의 사례까지 점검할 수 있습니다.

이미지가 누락된 경우 대상 경로를 실제 폴더 트리와 비교해 보세요. 시작 노트 폴더, 각 ../, 모든 하위 폴더 이름, 파일 이름 철자, 확장자 및 대소문자를 확인합니다. 경로를 수정한 후 이동된 사본에서 다시 확인하세요.

이는 실질적인 테스트 방법일 뿐, 모든 앱에서 완벽하게 호환된다는 보장은 아닙니다. 표준 마크다운은 이미지 문법을 정의하지만, 뷰어에 따라 고유한 규칙을 추가할 수 있습니다. 예를 들어 Obsidian은 마크다운 이미지 문법과 자체 임베드 문법(![[image.jpg]])을 모두 지원하며, 설정에서 상대 경로, 볼트 루트(vault-root), 최단 경로 링크 형식을 별도로 제공합니다. 볼트 기반 앱에서 일기를 열어보는 경우 표준 마크다운 대상을 사용하는지, 아니면 앱 전용 임베드 및 링크 설정을 사용하는지 확인하세요. Obsidian Help: Embed files Obsidian Help: Settings

이동 후 깨진 이미지 원인 진단하기

이미지가 나타나지 않는 경우, 먼저 뷰어가 연 파일이 어떤 사본인지 확인하세요. 원래 노트를 확인하고 있으면서 이동된 노트를 보고 있다고 착각하기 쉽습니다. 그런 다음 해당 노트의 디렉터리에서 상대 경로를 직접 따라가며 지정된 이미지가 대상 위치에 존재하는지 확인하세요.

문제를 빠르게 좁히는 방법은 경로를 폴더 트리와 임시로 비교해 보는 것입니다. 2026-09-30.md가 Diary/2026/에 있다면 ../images/blue-mug.jpg는 Diary/images/blue-mug.jpg로 연결되어야 합니다. 경로가 의도한 폴더에 도달하지만 파일 이름이 Blue-Mug.JPG라면 파일 이름 참조 또는 실제 파일 이름을 일치하도록 수정하세요. 이미지가 파일 탐색기에서는 열리지만 노트에서 렌더링되지 않는다면, 남은 문제는 해당 뷰어가 로컬 마크다운 경로를 처리하는 방식일 수 있습니다. 해당 뷰어의 문서를 확인하거나 일반 마크다운 이미지 경로로 테스트해 보세요.

간단한 휴대성 규칙

로컬 일기 이미지를 일기의 최상위 폴더 아래에 두고, 이미지를 표시하는 노트를 기준으로 각 이미지 경로를 상대 경로로 작성하며, 일기를 이동할 때 폴더 구조를 유지하세요. 마지막으로 실제 뷰어에서 이동된 사본을 열어 대표적인 이미지들이 잘 표시되는지 확인하세요. 이러한 점검 루틴은 파일 간의 관계와 앱의 동작 방식을 함께 검증하므로 일상적인 사용 환경에서 안정적인 휴대성을 보장해 줍니다.

이 주제 더 살펴보기