On Markdown in (Java) documentation
Posted on January 24, 2023
As some folk have already noticed, we are investigating the possibility of supporting Markdown in Java documentation comments. Why are we doing this? It has been an informal request for a while now, since the emergence of Markdown as a popular authoring format, and so we're doing it for all the same reasons that authors prefer to use Markdown instead of raw HTML in standalone documentation. In particular, using raw HTML is somewhat clunky and visually intrusive, for simple formatting tasks, like font changes, lists, and tables, that are often desired in API documentation...
More at https://mail.openjdk.org/pipermail/javadoc-dev/2023-January/005563.html