Use markdown for inline documentation

The current inline documentation often uses HTML markup, for example here:

I wonder if it would not make more sense to use markdown for this kind of documentation. It’s much easier to parse and also much more readable in raw format.


We’re already doing this for 2.0 code (with some extension to markdown, such as using [[Component]] to represent {@link Component}.

Great :)