# Static images

Unfortunately, GitBook has a poor implementation of Markdown when it comes to images attributes: it converts alternative text (that should be an attribute inside `img`) into captions (using `figcaption`) and nothing else. That's a bad thing for accessibility — it means that screen readers won't be able to inform visually impaired users what that image is about properly. This issue was reported to the Engineering team; a solution is pending.

1. No media of any kind should replace proper instructions. Use any kind of media as an *addition* to the page, and not as he main source of information.