Documentation generator for your plugin, library or framework.
Last updated 2 years ago by naminho .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install docy 
SYNC missed versions from official npm registry.


Documentation generator for your plugin, library or framework.

Quick Start

The get started quickly create one or more Markdown .md files and inside that folder run the following from the console having node installed:

npm install -g docy

You'll be asked whether you want open the result in the browser and watch for changes.

Regular Installation

To get started set up a package.json in the folder where you want to keep the documentation.

  "name": "my-documentation",
  "scripts": {
    "start": "docy",
    "develop": "docy --watch --open",
    "build": "docy --build"

If you already have a package.json add the script that matches your needs best.

First install docy by running npm install docy and then generate the documentation running npm start.


The documentation is stored inside markdown files.



Files inside a folder will be ordered alphabetically, to avoid this and keep the desired order add numbers in front. The filename will only be used for the purpose of ordering the contents.


├── 1-introduction
│   ├──
│   └──
├── 2-installation
|   ├──
│   └──

For more complex documentations the files can be nested inside folders to represent different levels.


Here's how an example .md file could look like:

# Installation

to install run `npm i docy`.



The plugin can be configured by setting options in the package.json file.

  "name": "my-documentation",
  "scripts": {
    "start": "docy"
  "docy": {
    "title": "My Documentation"

The following options are available:

title default

Set the title of the documentation.

footer default empty

Set the footer content.

result default index.html

Name of the resulting documentation file.

dist default ./dist

Folder where the generated documentation should be placed.

single default true

Generate a single HTML file for the whole documentation. Set to false to generate a separate HTML file for every source file. Currently this will only generate separate files for the top level.

template default template.html

Path relative to the documentation directory pointing to an ejs template.



Current Tags

  • 1.0.3                                ...           latest (2 years ago)

3 Versions

  • 1.0.3                                ...           2 years ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (23)
Dev Dependencies (0)
Dependents (0)

Copyright 2014 - 2016 © |