JEP 467, Markdown Documentation Comments, proposes to enable JavaDoc documentation comments to be written in Markdown, improving documentation readability and ease of writing for developers.
"The split window showing the editor and preview is standard today for Markdown editors, providing a user-friendly way to see both the edited text and its rendered form, which helps in correcting errors before publishing."