Could you add support for GitHub markdown admonitions? https://github.com/orgs/community/discussions/16925
This would allow using admonitions in a readme file that will look nice in both GitHub and generated docs.
Current you get something like the following.
GitHub:

Doxygen:

Using something like @warning in markdown is a little weird, because that's a mention on GitHub.