9

I need a NodeJS based generator that takes as input a JavaScript file and generate markdown documentation.

Example:

/**
 * foo
 * foo description
 *
 * @name foo
 * @param {String} a Some description
 * @param {Object} b An object param
 * @return {Boolean} Some foo again
 */
function foo (a, b) {
   /* do something */
   return Boolean(...);
}

The result will be something like this:

## foo (a, b)
foo description
  - `a` (String): Some description
  - `b` (Object): An object param
Returns (Boolean) Some foo again

3 Answers 3

1

I'm not sure it generates exactly the output you're looking for (and that might be hard to find), but JSDoc follows your other needs: JS doc generator, in node.js.

1
  • 1
    Thanks for your answer – but unfortunately, this post does not contain enough information to be considered a high quality answer. Please read our discussion on what makes an answer high quality to see if you can incorporate some of these improvements into your answer.
    – Izzy
    May 28, 2014 at 13:04
0

I'm not sure there is a program that directly generates markdown doc. Until somebody makes it, you can generate a html doc that's as simple as possible and then convert it to markdown. Here's a tool to do the conversion

http://domchristie.github.io/to-markdown/

0

Based on markdox library, I created a command line tool named blah that does this task.

To install it do:

$ npm install -g blah

To generate a markdown documentation for a js file:

$ blah docs your-file.js

This will create DOCUMENTATION.md file. For more information check out the blog post and the GitHub repository.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.