Z403: MISSING_ALT

Severity: warning Penalty: 1.0 point Category: content Auto-fixable: No

Rationale

This accessibility rule is triggered when an HTML or Markdown image tag (such as ![](image.png) or <img src="...">) lacks descriptive alternative text (alt). Accessible image captions are required for screen readers.

How to Fix

Inspect the flagged location in the Markdown file and update the content or configuration:

Bad (Triggers Z403)

<!-- BAD: Image tag without alternative text description -->
!\[\](../assets/diagram.png)

Good (Resolves Z403)

<!-- GOOD: Image tag with clear alternative text -->
![System Architecture Diagram](../assets/diagram.png)

Configuration

# Audited across all Markdown image tags

Reference

See the Finding Codes Index for finding code details.