Markdown and plantuml

[astubbs]

We use pegdown-doclet for our published javadoc: https://github.com/Abnaxos/pegdown-doclet

It's awesome, and allows us to embed plantuml diagrams too.

We want to use swagger for our rest api as well. But atm, we'd point the user to our published javadoc for more detail to see the markdown formatting and uml diagrams.

It would be awesome to extend swagger doclet to use pegdown. Perhaps it's possible to delegate inner html rendering of the comment block to pegdown-doclet or something...