본문 바로가기

Markdown 이미지 ALT 검사기

브라우저 처리

Markdown 문서의 모든 이미지에 대체 텍스트(ALT)가 있는지 검사합니다. 비어 있거나 공백뿐인 이미지를 번호와 경로로 알려 주고 적용 비율을 보여 줍니다.

사용 전 확인
  • 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
도구 실행입력 후 결과 확인
Markdown 이미지 ALT 검사기 샘플 실행

![](chart.png)처럼 대괄호가 빈 이미지는 화면 낭독기 사용자에게 '이미지'라고만 읽히고, 이미지가 깨졌을 때도 아무 설명이 남지 않습니다. 검색 엔진도 ALT로 이미지 내용을 이해합니다.

브라우저 처리
샘플 결과
1	ALT 없음	(비어 있음)	hero.png
2	ALT 있음	매출 추이 차트	chart.png
3	ALT 없음	 	icon.svg
ALT 적용: 1/3
자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

Markdown 이미지 ALT 검사기 사용 가이드

![](chart.png)처럼 대괄호가 빈 이미지는 화면 낭독기 사용자에게 '이미지'라고만 읽히고, 이미지가 깨졌을 때도 아무 설명이 남지 않습니다. 검색 엔진도 ALT로 이미지 내용을 이해합니다.

이 검사기는 문서의 ![설명](경로) 이미지를 순서대로 찾아 'ALT 있음/ALT 없음'과 설명 글자, 경로를 한 줄씩 보여 줍니다. 공백만 들어 있는 ALT도 없는 것으로 보며, 마지막 줄에 'ALT 적용: 1/3'처럼 비율이 나옵니다.

참조 방식 이미지(![설명][키])와 HTML <img> 태그는 검사하지 않습니다.

사용 방법

  1. '.md·.txt 파일'에서 이미지가 들어 있는 문서를 고르거나 'Markdown 내용'에 원고를 붙여 넣습니다.
  2. '실행'을 누르면 이미지마다 번호, ALT 여부, 설명, 경로가 한 줄씩 나옵니다.
  3. 'ALT 없음'인 이미지의 대괄호 안에 내용을 설명하는 글을 넣고 다시 실행해 비율을 확인합니다.

예시: 설명이 빠진 이미지가 섞인 원고

입력
![](hero.png)
![매출 추이 차트](chart.png)
![ ](icon.svg)
결과
1	ALT 없음	(비어 있음)	hero.png
2	ALT 있음	매출 추이 차트	chart.png
3	ALT 없음	 	icon.svg
ALT 적용: 1/3

3번처럼 공백 한 칸만 넣은 ALT도 '없음'으로 셉니다.

이럴 때 쓰면 좋아요

  • 블로그 글을 발행하기 전에 이미지 설명이 빠졌는지 확인할 때
  • 웹 접근성 점검 항목 중 이미지 대체 텍스트를 확인할 때
  • 이미지가 많은 매뉴얼 문서의 ALT 적용 비율을 보고할 때
  • 이미지 검색에서 상품 사진이 잘 찾아지도록 설명 원고의 ALT를 채울 때

문제가 생겼을 때

이미지가 있는데 'ALT 적용: 0/0'

![설명][키] 참조 방식이나 HTML <img>로 넣은 이미지는 세지 않습니다. ![설명](경로) 형식인지 확인하세요.

ALT에 파일 이름만 들어 있음

'IMG_0012.png' 같은 ALT는 '있음'으로 나오지만 설명이 되지 않습니다. 이미지에 무엇이 보이는지 한 문장으로 바꿔 쓰세요.

활용 팁

  • 좋은 ALT는 '그림'이나 '사진' 같은 말 없이 내용을 짧게 적습니다. 예: '2024년 월별 매출이 꾸준히 오르는 막대 차트'.
  • 글에서 이미 설명한 장식용 아이콘은 HTML에서는 alt를 비워 두는 것이 맞습니다. 이런 경우 'ALT 없음'은 의도한 것인지만 확인하세요.

자주 묻는 질문

ALT는 몇 자 정도가 좋나요?

보통 한두 문장, 125자 안쪽을 권장합니다. 긴 설명이 필요한 도표는 본문에 따로 풀어 쓰고 ALT는 요약만 남기세요.

제목 텍스트 ![a](b.png "제목")도 ALT로 보나요?

아니요. 대괄호 안의 글만 ALT입니다. 따옴표 안의 제목은 마우스를 올렸을 때 뜨는 말풍선이라 화면 낭독기가 읽지 않을 수 있습니다.

이미지 파일이 실제로 있는지도 확인하나요?

아니요. ALT만 검사합니다. 경로가 살아 있는지는 Markdown 로컬 링크·이미지 검사기로 확인하세요.