@nphyx/esdox

Clean, simple JSDoc -> Github Markdown generator with support for ES6+.

Usage no npm install needed!

<script type="module">
  import nphyxEsdox from 'https://cdn.skypack.dev/@nphyx/esdox';
</script>

README

ESDox build status Coverage Status npm (scoped)

ESDox is a simple jsdoc 3 generator based on jsdox.

It pulls documentation tags based on a subset of jsdoc 3 from your javascript files and generates github-flavored markdown files.

Relies on the JSDoc3 parser to get the full AST including comments.

Compared to JSDox, ESDox incorporates updated dependencies with support for ES6/7 features, generates more nicely-formatted documentation, and intends to support a more comprehensive set of JSDoc3's tags.

Usage

ESDox can be used as a module or from the command line.

As a Node Module

const esdox = require("esdox").main;
esdox({input:["src","lib","index.js"],output:"docs/"})
  .then(() => /* whatever you want to do after */);

CLI Options

esdox -h # see help for full options
esdox --output docs src lib index.js

Resources

Original JSDox author and contributors

  • Pascal Belloncle (psq, Original author)
  • Sam Blowes (blowsie)
  • Todd Henderson (thenderson21)
  • Nic Jansma (nicjansma)
  • Joel Kemp (mrjoelkemp)
  • Ron Korving (ronkorving)
  • Mike MacMillan (mmacmillan)
  • Michael Martin-Smucker (mlms13)
  • Akeem McLennon (bluelaguna)
  • Gabor Sar (gaborsar)
  • Marc Trudel (stelcheck)
  • Anselm Stordeur (anselmstordeur)
  • Vladimir de Turckheim (vdeturckheim)

License

See (LICENSE.md).