It would be nice if JavaDoc was extended to accept markup language hints out of the box. For example: /**markdown * */ Would interpret the content of the comment as markdown when generating the docs. Or: /**asciidoc * */ would treat the comment as asciidoc. What do you think? -- Best regards, Behrang Saeedzadeh