이미지

이 문서는 마크다운 이미지 문법을 기본 마크다운과 위키링크 확장 두 가지로 구분해서 정리합니다.

이미지 폴더 구조

이미지 문서는 문서 파일과 이미지 파일을 같은 폴더에 보관하는 것을 기본 규칙으로 사용합니다. 이 구조를 지키면 상대 경로가 단순해지고 문서 이동 시 수정 범위를 최소화할 수 있습니다.

markdown-guide/
- 02-image/
  - index.md
  - profile_img.png
  - apple.svg
  - windows.svg

기본 마크다운

오리지널 마크다운 ![]() 문법입니다. 이 테마에서는 항상 블록(<figure>)으로 렌더링됩니다. 문장 중간에 삽입해도 텍스트 흐름에 녹아들지 않고 독립 블록으로 분리됩니다.

캡션 없음

작성 문법

![](./profile_img.png)

렌더링

동해물과 백두산이 마르고 닳도록, 하느님이 보우하사 우리나라 만세. Lorem ipsum dolor sit amet, consectetur adipiscing elit. 봄이 오면 꽃이 피고, 여름에는 나무가 무성합니다.

새는 하늘을 날고, 물고기는 물 속을 헤엄칩니다. 계절은 반복되지만주. 강물은 유유히 흘러가고, 구름은 바람에 따라 모양을 바꿉니다.

캡션 있음

작성 문법

![](./profile_img.png '예시 화면')

렌더링

하늘과 바람과 별과 시를 노래하며 살아가는 것은 참으로 행복한 일이다. 가나다라마바사아자차카타파하, 이것은 화면 서식 확인을 위한 더미 텍스트입니다.

강물은 유유히 흘러가고, 구름은 바람에 따라 모양을 바꿉니다. 빛이 있으면 반드시 그림자가 따르는 법이며, 모든 시작은 한 걸음에서 비롯됩니다.

이미지 경로 표기

이미지 경로는 현재 폴더 기준 표기를 기본으로 사용합니다.

작성 문법

![](profile_img.png)
![](./profile_img.png)

렌더링

봄이 오면 꽃이 피고, 여름에는 나무가 무성합니다. Lorem ipsum dolor sit amet, consectetur adipiscing elit. 강물은 유유히 흘러가고, 구름은 바람에 따라 모양을 바꿉니다.

새는 하늘을 날고, 물고기는 물 속을 헤엄칩니다주. 매번 새롭습니다. 모든 시작은 한 걸음에서 비롯됩니다.

위키링크 확장 (옵시디언 호환)

![[파일명]]은 오리지널 마크다운이 아닌 옵시디언 호환 확장 문법입니다. 텍스트와 같은 줄에 있을 때 inline-icon 클래스가 자동 적용되어 텍스트 흐름에 맞게 렌더링됩니다. 기본 마크다운 ![]() 방식과 달리 인라인 렌더링을 지원하는 것이 핵심 차이점입니다. 모달, 캡션 등 추가 기능은 이미지 디렉티브에서 확인합니다.

인라인 아이콘

작성 문법

운영체제 아이콘 ![[apple.svg]] 와 ![[windows.svg]] 를 본문 중간에 배치합니다.

렌더링

동해물과 백두산이 마르고 닳도록, 하느님이 보우하사 우리나라 만세. 운영체제 아이콘 와 를 본문 중간에 배치합니다. 봄이 오면 꽃이 피고, 여름에는 나무가 무성합니다.

하늘과 바람과 별과 시를 노래하며 살아가는 것은 참으로 행복한 일이다. 운영체제 아이콘 와 를 본문 중간에 배치합니다. 새는 하늘을 날고, 물고기는 물 속을 헤엄칩니다주 매번 새롭습니다.

가을 하늘 공활한데 높고 구름 없이 밝은 달은 우리 가슴 일편단심일세. 운영체제 아이콘 와 를 본문 중간에 배치합니다. 모든 시작은 한 걸음에서 비롯됩니다.