This update's primary goal is to simplify the process of writing and reading documentation comments in Java source code. By allowing Markdown, which is known for its simplicity and readability, developers can avoid the complexities associated with HTML and JavaDoc tags.
Markdown is a lightweight markup language that is easy to read and write. It supports simple document structures like paragraphs, lists, styled text, and links, making it a suitable replacement for HTML in documentation comments.
Consider the following JavaDoc comment for java.lang.Object.hashCode written in the traditional format...
[
Collection
]
[
|
...
]