Skip to content
RESTful web API Documentation Generator.
JavaScript HTML CSS Dockerfile
Branch: master
Clone or download
manishsaraan Merge pull request #769 from ethan92429/addCopyDefinitions
Support copyDefinitions apicore option with a --no-copy command line …
Latest commit bfe86d9 Jul 5, 2019


Generates a RESTful web API Documentation.

Build Status Dependency Status NPM version

Changes from previous version visit

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

Documentation at or as Docset.

Example output.

HELP NEEDED! Search for a Developer

Because of my limited time i need one or more devs that could build and maintain a "Send Sample Request Plugin".

The Plugin should be loose coupled to the template, so it should be a separate project. This Plugin should send example data to an API-Endpoint and process the response. Supported formats should be JSON, XML, whatever.

Many issues belong to the current (unmaintained) plugin, (Milestone: Send Sample Request Plugin)( If you want ot work on this, please send me a PM.


$ 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:

Supported programming languages

  • 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.

Plugins (extend apiDoc)

apiDoc will auto include installed plugins.

  • apidoc-plugin-schema Generates and inject apidoc elements from api schemas. npm install apidoc-plugin-schema

Build tools



Docker images


Extend apiDoc and write your own Plugin

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.

Gitter chat

You can’t perform that action at this time.