An example defines the issue. Given the following JavaDoc: /** The title. Some issues: <ol> <li>One</li> <li>Two</li> </ol> */ If wrapping is enabled (which is not really optional) then the list above gets smashed into one unreadable line. If "keep blank lines" is enabled, this can be prevented by putting in lots of extra blank lines, but what is really needed is a way to specify that for html tags in some list, if they are at the beginning of a line they stay at the beginning of a line after formatting. In fact the list of unwrappable tags probably does not need to be settable – any block level tag should start a new line.