The documentation system for modern JavaScript

[![Circle CI](https://circleci.com/gh/documentationjs/documentation/tree/master.svg?style=shield)](https://circleci.com/gh/documentationjs/documentation/tree/master) [![npm version](https://badge.fury.io/js/documentation.svg)](http://badge.fury.io/js/documentation) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/documentationjs/documentation?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) [![Inline docs](http://inch-ci.org/github/documentationjs/documentation.svg?branch=master&style=flat-square)](http://inch-ci.org/github/documentationjs/documentation) [:date: Current maintenance status](https://github.com/documentationjs/documentation/wiki/Current-maintenance-status) - Supports modern JavaScript: ES5, ES2017, JSX, Vue and [Flow](https://flow.org/) type annotations. - Infers parameters, types, membership, and more. Write less documentation: let the computer write it for you. - Integrates with GitHub to link directly from documentation to the code it refers to. - Customizable output: HTML, JSON, Markdown, and more ## Examples - [HTML output with default template](https://documentation.js.org/html-example/) - [Markdown](https://github.com/documentationjs/documentation/blob/master/docs/NODE_API.md) - [JSON](https://documentation.js.org/html-example/index.json) ## Documentation - [Getting Started](docs/GETTING_STARTED.md): start here - [Usage](docs/USAGE.md): how to use documentation.js - [Recipes](docs/RECIPES.md): tricks for writing effective JSDoc docs - [Node API](docs/NODE_API.md): documentation.js's self-generated documentation - [Configuring documentation.js](docs/CONFIG.md) - [FAQ](docs/FAQ.md) - [Troubleshooting](docs/TROUBLESHOOTING.md) - [Theming](docs/THEMING.md): tips for theming documentation output in HTML - [See also](https://github.com/documentationjs/documentation/wiki/See-also): a list of projects similar to documentation.js ## User Guide Globally install `documentation` using the [npm](https://www.npmjs.com/) package manager: ```sh $ npm install -g documentation ``` This installs a command called `documentation` in your path, that you can point at [JSDoc](https://jsdoc.app/about-getting-started.html)-annotated source code to generate human-readable documentation. First, run `documentation` with the `--help` option for help: ```sh Usage: # generate markdown docs for index.js and files it references documentation build index.js -f md # generate html docs for all files in src, and include links to source files in github documentation build src/** -f html --github -o docs # document index.js, ignoring any files it requires or imports documentation build index.js -f md --shallow # validate JSDoc syntax in util.js documentation lint util.js # update the API section of README.md with docs from index.js documentation readme index.js --section=API # build docs for all values exported by index.js documentation build --document-exported index.js # build html docs for a TypeScript project documentation build index.ts --parse-extension ts -f html -o docs Commands: build [input..] build documentation lint [input..] check for common style and uniformity mistakes readme [input..] inject documentation into your README.md Options: --version Show version number [boolean] --help Show help [boolean] ``` ## [Contributing](CONTRIBUTING.md) _We have plenty of [issues](https://github.com/documentationjs/documentation/issues) that we'd love help with._ - Robust and complete `JSDoc` support, including typedefs. - Strong support for HTML and Markdown output - Documentation coverage, statistics, and validation documentation is an OPEN Open Source Project. This means that: Individuals making significant and valuable contributions are given commit-access to the project to contribute as they see fit. This project is more like an open wiki than a standard guarded open source project.

	Stars	Issues	Version	Updated	Created
documentation	5,762	206	14.0.3	3 months ago	9 years ago
jsdoc	14,738	438	4.0.2	a year ago	13 years ago
jsdoc-to-markdown	1,620	54	8.0.1	3 months ago	10 years ago
typedoc	7,348	33	0.25.13	11 days ago	10 years ago

documentation vs jsdoc vs jsdoc-to-markdown vs typedoc

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Popular Searches

Sick of boring JavaScript newsletters?

Downloads in past