{"_id":"mdextract","_rev":"481668","name":"mdextract","description":"Extracts `/** code comments */` from code files and turns them into markdown  docs. Supports JavaScript-style comments (other languages to come).","dist-tags":{"latest":"1.0.0"},"maintainers":[{"name":"rstacruz","email":"rico@ricostacruz.com"}],"time":{"modified":"2021-08-05T09:40:11.000Z","created":"2014-07-14T03:17:43.056Z","1.0.0":"2014-07-15T08:08:11.639Z","0.1.0":"2014-07-14T03:17:43.056Z"},"users":{},"author":{"name":"Rico Sta. Cruz","email":"hi@ricostacruz.com"},"repository":{"type":"git","url":"https://github.com/rstacruz/mdextract.git"},"versions":{"1.0.0":{"name":"mdextract","description":"Extracts `/** code comments */` from code files and turns them into markdown  docs. Supports JavaScript-style comments (other languages to come).","keywords":[],"author":{"name":"Rico Sta. Cruz","email":"hi@ricostacruz.com"},"version":"1.0.0","repository":{"type":"git","url":"https://github.com/rstacruz/mdextract.git"},"main":"index","scripts":{"test":"mocha"},"devDependencies":{"mocha":"^1.18.2","chai":"^1.9.1","coffee-script":"^1.7.1","sinon":"^1.9.0"},"bin":{"mdextract":"./bin/mdextract"},"license":"MIT","dependencies":{"nopt":"^2.2.1"},"gitHead":"f7d3e4401e3083d705e10e41e7a4fcbd11b7b3b2","bugs":{"url":"https://github.com/rstacruz/mdextract/issues"},"homepage":"https://github.com/rstacruz/mdextract","_id":"mdextract@1.0.0","_shasum":"028c0c9105506b2beadcd7d96cdbec6eaf9b4176","_from":".","_npmVersion":"1.4.16","_npmUser":{"name":"rstacruz","email":"rico@ricostacruz.com"},"maintainers":[{"name":"rstacruz","email":"rico@ricostacruz.com"}],"dist":{"shasum":"028c0c9105506b2beadcd7d96cdbec6eaf9b4176","size":9559,"noattachment":false,"key":"/mdextract/-/mdextract-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/mdextract/download/mdextract-1.0.0.tgz"},"directories":{},"publish_time":1405411691639,"_cnpm_publish_time":1405411691639,"_hasShrinkwrap":false},"0.1.0":{"name":"mdextract","description":"Extracts `/** code comments */` from code files and turns them into markdown  docs. Supports JavaScript-style comments (other languages to come).","keywords":[],"author":{"name":"Rico Sta. Cruz","email":"hi@ricostacruz.com"},"version":"0.1.0","repository":{"type":"git","url":"https://github.com/rstacruz/mdextract.git"},"main":"index","scripts":{"test":"mocha"},"devDependencies":{"mocha":"^1.18.2","chai":"^1.9.1","coffee-script":"^1.7.1","sinon":"^1.9.0"},"bin":{"mdextract":"./bin/mdextract"},"license":"MIT","dependencies":{"nopt":"^2.2.1"},"gitHead":"a36e681d77b4aab566d071be078d1a9ad7466a0e","bugs":{"url":"https://github.com/rstacruz/mdextract/issues"},"homepage":"https://github.com/rstacruz/mdextract","_id":"mdextract@0.1.0","_shasum":"ab1dc862c5bef0ec51fef9178e7b23c2e3733ffd","_from":".","_npmVersion":"1.4.16","_npmUser":{"name":"rstacruz","email":"rico@ricostacruz.com"},"maintainers":[{"name":"rstacruz","email":"rico@ricostacruz.com"}],"dist":{"shasum":"ab1dc862c5bef0ec51fef9178e7b23c2e3733ffd","size":8596,"noattachment":false,"key":"/mdextract/-/mdextract-0.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/mdextract/download/mdextract-0.1.0.tgz"},"directories":{},"publish_time":1405307863056,"_cnpm_publish_time":1405307863056,"_hasShrinkwrap":false}},"readme":"# mdextract\n\nExtracts `/** code comments */` from code files and turns them into markdown \ndocs. Supports JavaScript-style comments (other languages to come).\n\n    $ npm install -g mdextract\n    $ mdextract --help\n\nUse it to extract comments into a doc:\n\n    $ mdextract file.js > docs.md\n\nOr update a doc:\n\n    $ cat README.md\n\n      add `include` comments to your markdown file\n\n      <!-- include: file.js -->\n      <!-- /include: file.js -->\n\n    $ mdextract --update README.md\n\n...the `--update` mode is great for making Readme-based documentation in small \nprojects. It is [idempotent].\n\nFile format\n-----------\n\n__Sections:__ mark them with comments beginning with two stars.\n\n```\n/**\n * Sections:\n * Start your sections with two stars.\n *\n * If your first line of text ends in a colon (:), it will be turned into an\n * `<h3>` heading.\n */\n```\n\n__Main sections:__ three stars.\n\n```\n/***\n * Main sections:\n * If you start sections with three stars, the headings will be turned into\n * `<h2>` headings.\n */\n```\n\n__Code blocks:__ They will be converted into syntax-highlighted code fences.\n\n```\n/**\n * An example:\n *\n *     function () {\n *       return true;\n *     }\n */\n```\n\n__Definition lists:__ Use `~` as a bullet. Great for parameter lists.\n\n```\n/**\n * ~ name: description\n * ~ id: the identifier\n * ~ callback (Function): the callback to run afterwards\n */\n```\n\n__Sample usage:__ Use `name : usage` as your first line to specify a sample \nusage.\n\n```\n/**\n * push : push(name, fn)\n * Adds an item to the stack.\n */\n```\n\n__Single-line mode:__ for short documentations.\n\n```js\n/** id: the identifier. */\nthis.id = null;\n\n/** name: the name. */\nthis.name = \"Hello\";\n```\n\nExamples\n--------\n\n * [index.js](index.js) from mdextract ([output](API.md))\n * [navstack.js] from Navstack ([output][navstack-out])\n\n[navstack.js]: https://github.com/rstacruz/navstack/blob/master/navstack.js\n[navstack-out]: https://github.com/rstacruz/navstack/blob/master/Readme.md\n\nThanks\n------\n\n**mdextract** © 2014+, Rico Sta. Cruz. Released under the [MIT License].<br>\nAuthored and maintained by Rico Sta. Cruz with help from [contributors].\n\n> [ricostacruz.com](http://ricostacruz.com) &nbsp;&middot;&nbsp;\n> GitHub [@rstacruz](https://github.com/rstacruz) &nbsp;&middot;&nbsp;\n> Twitter [@rstacruz](https://twitter.com/rstacruz)\n\n[MIT License]: http://mit-license.org/\n[contributors]: http://github.com/rstacruz/mdextract/contributors\n[idempotent]: https://en.wikipedia.org/wiki/Idempotent\n","_attachments":{},"homepage":"https://github.com/rstacruz/mdextract","bugs":{"url":"https://github.com/rstacruz/mdextract/issues"},"license":"MIT"}