> For the complete documentation index, see [llms.txt](https://documentarians.gitbook.io/metadocumentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentarians.gitbook.io/metadocumentation/redirect/media/static-images.md).

# 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.