mirror of
https://github.com/DavidAnson/markdownlint.git
synced 2025-12-16 22:10:13 +01:00
30 lines
776 B
Markdown
30 lines
776 B
Markdown
# `MD045` - Images should have alternate text (alt text)
|
|
|
|
Tags: `accessibility`, `images`
|
|
|
|
Aliases: `no-alt-text`
|
|
|
|
This rule is triggered when an image is missing alternate text (alt text) information.
|
|
|
|
Alternate text is commonly specified inline as:
|
|
|
|
```markdown
|
|
|
|
```
|
|
|
|
Or with reference syntax as:
|
|
|
|
```markdown
|
|
![Alternate text][ref]
|
|
|
|
...
|
|
|
|
[ref]: image.jpg "Optional title"
|
|
```
|
|
|
|
Guidance for writing alternate text is available from the [W3C](https://www.w3.org/WAI/alt/),
|
|
[Wikipedia](https://en.wikipedia.org/wiki/Alt_attribute), and
|
|
[other locations](https://www.phase2technology.com/blog/no-more-excuses).
|
|
|
|
Rationale: Alternate text is important for accessibility and describes the
|
|
content of an image for people who may not be able to see it.
|