Prosím, co přesně na tom vidíte jako "super"?
Markdown je otřesný bastl, proto zde taky používají CommonMark, který se to snaží nějak usměrnit. Ano, někde je asi taková možnost soudobější (což neznamená nutně lepší) než psát Javadoc/HTML, ale zrovna tohle rozhodnutí mi přijde jako zcela zbytečné zesložitění implementace, která už tak není nikterak jednoduchá. Navíc to vyžaduje knihovnu commonmark-java, tedy další závislost...
Ani vlastně nevím, proč by to vůbec měl jazyk explicitně podporovat, když se jedná o komentáře, které by v příčetném prostředí měly být vyjmuty z interpretace. Maximálně by se na tento stupeň analýzy kódu mělo být možné připojit a udělat si tam nějaké další zpracování - přesně aby se nemusely dělat takové nesmysly.
Samozřejmě jazyk taky mohl mít od začátku systém na podporu metadat. Do toho se daly schovat jak typy, tak další informace, které by se daly automatizovaně zpracovat během překladu, při testování, nebo případně za běhu.