Ask HN: Best Tool to Document APIs?

2 points by siavosh ↗ HN
Looking for a tool to document an API for other developers? Preferably free, nice design.

3 comments

[ 3.3 ms ] story [ 14.4 ms ] thread
Stripes Markdoc got some press recently: https://markdoc.io/
That is a markdown rendering tool with a bunch of extras for your markdown

Sure they use it for their APIs among other things, but it's not purpose built for API documentation with ease

Have you looked into https://swagger.io/ ?

You'll want to invest some time into automating doc generation to some degree as well. That depends on your tech stack and libraries used. Lots of choices / variability therein