Scaladoc2の記法

Scaladoc2の記述について以下が参考になりました。

Scaladoc 2 | The Scala Programming Language

Authors of documentation no longer have to use HTML tags in their comments.
Instead, Scaladoc supports a wiki-like syntax very similar to that used in Trac.
In general, Scaladoc authors should no longer use HTML tags in documentation as
Scaladoc may in the future also generate documentation in other formats than
HTML.

wiki記法みたいな感じで書けるのね。で、syntaxは少し下に書いてあります。

/** This is a paragraph
*
* This is another paragraph (note the empty line above) containing '''bold''',
* ''italic'', `monospace`,
* __underline__, ^superscript^, and ,,subscript,, words.
*
* {{{
* Multi-line code can be inserted as a block and will be printed as monospace
* text.
* It isn't parsed as Scala, with keyword highlighting, but may be in the
* future.
* }}}
*
* In the near future, wiki syntax will also support bullet or number lists as
* well as links to the www and to other pages inside the documentation. */

充実はしてないけど、、、htmlタグ書くよりはマシか。