By aPOST in 마크다운 — 2024년 1월 20일

[markdown] 마크다운 이미지 연결하기

마크다운 문서 안에 이미지를 표시합니다.

마크다운 문서와 함께 이미지 파일을 포함해서 압축 파일 등으로 배포를 하거나, 소스코드와 함께 패키지로 배포할 때는 로컬 경로에 포함된 이미지 파일을 링크로 연결해서 표시할 수 있습니다.

마크다운 태그 중에서 구조가 가장 복잡하지만, 복잡하다고 해봐야 이미지 경로를 소괄호로 표시하는 것을 제외하면 대체 텍스트와 옵션 타이틀 두 가지를 부가적으로 작성하는 정도가 전부입니다.

이미지 태그는 다음과 같습니다. 느낌표로 시작하고 소괄호로 이미지 파일 경로를 감싸서 표시합니다.

이미지를 표시할 수 없을 때 이미지를 대신해서 표시하는 텍스트를 느낌표 뒤에 대괄호 ([브라켓])로 작성할 수 있습니다.

이미지 제목을 텍스트로 추가 표시하고 싶으면 이미지 파일 경로 뒤에 쌍 따옴표로 텍스트를 추가할 수 있습니다. 이미지 위에 마우스 오버를 하면 제목 텍스트가 표시됩니다.

HTML 이미지 태그가 제공하는 이미지 크기 설정 옵션은 마크다운에서는 제공하지 않습니다.

마크다운 문서에 이미지 링크로 이미지를 표시할 때는 문서안에 표시할 적정한 크기로 미리 조절해서 사용하는 것이 좋습니다.

로컬 경로를 표시할 때는 현재 마크다운 문서가 있는 위치가 루트 경로가 된다는 점에 주의해야 합니다.

현재 마크다운 문서 위치 밑에 “images/path/” 폴더가 차례로 있고 “path” 폴더 안에 “filename.jpg” 이미지 파일이 있는 것입니다.