JEP 467: Markdown Documentation Comments
Summary
Enable JavaDoc documentation comments to be written in Markdown rather
than solely in a mixture of HTML and JavaDoc @-tags.
Goals
Make API documentation comments easier to write and easier to read in source
form by introducing the ability to use Markdown syntax in documentation
comments, alongside HTML elements and JavaDoc tags.
Do not adversely affect the interpretation of existing documentation comments.
Extend the Compiler Tree API to enable other tools that analyze
documentation comm...
Read more at openjdk.org