Kami's Corner

Here's how to actually add alt text to images - re: Jacob Varney

Heya! I just saw this post from Jacob Varney about adding alt text to your stuff.

And, while I agree with the notion of doing that, the method he shows is sadly also wrong, and won't meaningfully improve your sites accessibility.

In markdown, to add alt text to your images, you do this:

![A description of your image](https://image-url.com/example.png)  

The syntax Jacob showed is actually for adding title text, which is intended to show when hovering over an image, not for accessible image descriptions. Depending on the screenreader, it might not be read at all.

I've already emailed Jacob, but i figured I'd make a seperate post about this as well, to make sure noone is under the illusion that their images are accessible when they actually aren't.