I believe it's a great move towards having Markdown supported for javadoc, but adding the 3 slashes format just seems rather odd.
Lots of editors use a hint to denote how to render the content with code block tags, e.g.: ```html <..... ``` Would it not be a good solution for Javadoc as well? We could have a type after the start of the Javadoc opening tag, e.g.: /**markdown * * */ This also has the added benefit of being future proof if another format is introduced later. -- Darren
