Well, you do need things like emphasis, lists, headings etc., which aren't typically part of a programming language.
The MarkDown code character backtick is especially great for Java since it’s not a metacharacter in the Java syntax.
[1] I didn’t mean writing docs in Java itself, whatever that would look like.