开发者

Stackoverflow markup for javadoc

After a while, I'm back writing JavaDoc. At the same time I grew fond of SO's markup, which is way more readable in plaintext than HTML. (Even the back tick which I never used before, ever).

/**
 * I'm talking about things like <code>Clas开发者_Go百科sName</code> here.
 * <p>
 * And of course the well-known <code>&lt;p&gt;</code>.<br>
 * Should I go on?
 */

Has anyone written some filter thingy which translates SO markup to HTML in the JavaDoc tool chain?

Alternatively as comments any pointers would be welcome how to write extensions to JavaDoc with such functionality (I'm mainly interested in the interface if there is any available).


There appears to be a Markdown Doclet for Javadoc, which should do what you want.

It's made by StackOverflow-user Richard Nichols. He has written a blog post on it, which includes a screenshot, of some example input/output.


MarkdownDoclet is a bit outdated.

For Java 7, use https://github.com/Abnaxos/pegdown-doclet

0

上一篇:

下一篇:

精彩评论

暂无评论...
验证码 换一张
取 消

最新问答

问答排行榜