API default delimiters

[mbourne]

I set up an auto render page from scratch recently and couldn't figure out why some of the environments worked, and others didn't.

Then I found this page https://katex.org/docs/autorender.html which lists the default delimiters for the API. To get all the math on the page to render, I needed to include the default delimiters as listed plus the ones I was using on the page.

I thought this created some confusion that could have been avoided if all the supported environments were included in the the default list. I'm assuming KaTeX goes looking for math within each delimiter pair one by one, but I expect there would be a negligible performance hit if it wasn't to find some (even most) of the delimiters.

Or am I missing something?

[mbourne]

Any comment on this?

I feel newcomers could be tripped up on this. I was, and I've been using KaTeX for some time.