Hacker News Reader

Related, and quite good: http://apiary.io/

Apiary not only auto-creates the docs for you, but also auto-creates a mock API which will return the example responses from your docs

Apiary's awesome, but it's great to see open-source alternatives. Every closed-source, lockin-producing service I use is another thing to worry about.

If Apiary would want to lock you in, we'd hardly open-source the parser Iglo is based on and endorse Iglo itself ;)

Iglo was given life from our internal need and requirements

So this is like Swagger?

Close, if you replace the Swagger's WADL/JSON with Markdown.

Iglo - transform your markdown-based API spec into interactive web documentation