node package manager


RESTful web API Documentation Generator


Generates a RESTful web API Documentation.

Changes from previous version visit

apiDoc creates a documentation from API descriptions in your source code.

Documentation at

Example output.

npm install apidoc -g

 * @api {get} /user/:id Request User information
 * @apiName GetUser
 * @apiGroup User
 * @apiParam {Number} id Users unique ID.
 * @apiSuccess {String} firstname Firstname of the User.
 * @apiSuccess {String} lastname  Lastname of the User.

apidoc -i example/ -o doc/

Creates from input files in example/ a documentation in path doc/.

More examples and best practice hints:

  • C#, Go, Dart, Java, JavaScript, PHP, Scala (all DocStyle capable languages):

      * This is a comment.
  • Clojure:

    ;; This is a comment.
  • CoffeeScript:

    This is a comment.
  • Erlang:

    This is a comment.
  • Perl

    # This is a comment. 
    This is a comment.
  • Python

    This is a comment.
  • Ruby

    This is a comment.

For details and an example view apidoc-plugin-test

Please add issues if you have a question or found a problem. Pull requests are welcome too!

A chat about apiDoc is on Gitter.