1. JEP 467 – Markdown in JavaDoc
Before Java 23:
JavaDoc relied heavily on HTML and specific tags, which made the documentation verbose and less readable. For example:
Now in Java 23:
You can use Markdown syntax directly—like #, **bold**, backticks ‘code‘`code`‘code‘, etc.This makes your documentation easier to read, write, and maintain.
With the introduction of Markdown, the documentation can be written in a more straightforward and readable manner. Here’s how the same example looks with Markdown:
markdown in javaDoc is enabled by default in java 23. It helps improved readability, simplified writing, reduced error etc.