imageAltTexts

Reports images without alternative text.

✅ This rule is included in the md logical preset.

Providing alternative text for images is essential for both accessibility and SEO. Without alternative text, users who rely on screen readers or other assistive technologies won’t be able to understand the content of images. Search engine crawlers are also unable to understand images without alt text or other labels.

This rule helps catch cases where alternative text is missing or contains only whitespace.

Examples

❌ Incorrect

![](sunset.png)

![ ](sunset.png)

![][ref]

[ref]: sunset.png

✅ Correct

![A beautiful sunset](sunset.png)

![Company logo][logo]

[logo]: logo.png

![Mountains and valleys](landscape.jpg)

When Not To Use It

If your images are automatically given alt text by frameworks, then this rule will report false positives.

Further Reading

• WebAIM: Alternative Text
• MD045 - Images should have alternate text

Equivalents in Other Linters

• ESLint: markdown/require-alt-text