Are there any issues with screen readers?

[Andrew Murdza]

I have to make my website accessible by April 25th due to a new law in the United States:

https://onlinelearningconsortium.org/olc-insights/2025/09/federal-digital-a11y-requirements/

I'm wondering if there is anything that breaks the screen reader, such as

• Defining Custom macros
• Certain macros or environments: https://docs.mathjax.org/en/latest/input/tex/macros/index.html (I heard from someone else that \begin{array}\end{array} may cause issues, but I'm not sure if that is also the case for MathJax)
• Something else that I didn't think of

I am asking because I will need to edit my code to somehow replace the "bad" macros.

Thanks,

Andrew Murdza

[Davide Cervone]

I'm wondering if there is anything that breaks the screen reader, such as

• Defining Custom macros

These should not be a problem.  Custom macros will use mathJax's internal macros in the end, and so will be no different from entering those macros directly.  Macros should not be a problem

• Certain macros or environments: https://docs.mathjax.org/en/latest/input/tex/macros/index.html (I heard from someone else that \begin{array}\end{array} may cause issues, but I'm not sure if that is also the case for MathJax)

MathJax's speech generation handles arrays and other aligned environments, so this should not be a problem.

• Something else that I didn't think of

If you are using unusual unicode characters that are non-mathematical in nature, then MathJax's speech-rule engine may not have translations for them.  I don't know of anything else that may be a problem, but of course, it is always possible something will not work the way you would like it to, and bugs do occur.

If you find issues, you can report them at

https://github.com/mathjax/MathJax/issues

We are often able to provide work-arounds that you can use until a problem is fixed in a formal release.

I hope that helps.

Davide