Image alternative text for accessibility

[yaxu]

In the manual it says: "An image with nonempty alt text, occurring by itself in a paragraph, will be rendered as a figure with a caption. The image’s alt text will be used as the caption."

However alt text is supposed to describe an image if it can't be seen, for example for people using screenreaders. This serves a different purpose from a caption.

Is it possible to turn off this behaviour, so e.g. the alt text is used as alt text in html? Ideally while still allowing a caption to be added.

[rnwst]

See this comment as to the reasons for the current behaviour. Basically, the alt text allows for inline formatting, and therefore that was chosen as the Figure caption. If you want to add alt text separately (as you should for accessibility reasons), you can do that like this:

![Figure caption](image.jpg){alt="Alt text goes here."}

Perhaps we should add this to the manual.

[yaxu]

Super thanks!

I tried adding it to the manual here: #11082