Best Tool to Document APIs?

Stripes Markdoc got some press recently: https://markdoc.io/

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