Then you should probably push adoption of markdown for javadoc (1). That and mermaid extension should be a good candidate. Or just use javadoc with an additional md plugin.

1 - https://mail.openjdk.org/pipermail/javadoc-dev/2023-January/...