jsdoc-to-markdown

从 jsdoc 注释的 JavaScript 生成 markdown 文档。「Generate markdown documentation from jsdoc-annotated javascript」

Github stars Tracking Chart

view on npm
npm module downloads
Gihub repo dependents
Gihub package dependents
Build Status
Coverage Status
js-standard-style
Join the chat at https://gitter.im/jsdoc2md/jsdoc2md

Upgraders, please read the release notes

jsdoc-to-markdown

Generates markdown API documentation from jsdoc annotated source code. Useful for injecting API docs into project README files.

Synopsis

1. Document your code using valid jsdoc comments.

/**
 * A quite wonderful function.
 * @param {object} - Privacy gown
 * @param {object} - Security
 * @returns {survival}
 */
function protection (cloak, dagger) {}

2. Run a command.

$ jsdoc2md example.js

3. Get markdown output.

## protection(cloak, dagger) ⇒ <code>survival</code>
A quite wonderful function.

**Kind**: global function, Param, Type, Description, ------, -------------------, ------------, cloak, <code>object</code>, Privacy gown, dagger, <code>object</code>, Security, ```

## Install

$ npm install --save-dev jsdoc-to-markdown


## See also

* [API documentation](https://github.com/jsdoc2md/jsdoc-to-markdown/blob/master/docs/API.md)
* The [wiki](https://github.com/jsdoc2md/jsdoc-to-markdown/wiki) for example output, FAQs, tutorials, plugins, use with gulp/grunt etc.

* * *

&copy; 2014-21 Lloyd Brookes \<75pound@gmail.com\>.

Tested by [test-runner](https://github.com/test-runner-js/test-runner).

Main metrics

Overview
Name With Ownerjsdoc2md/jsdoc-to-markdown
Primary LanguageJavaScript
Program languageJavaScript (Language Count: 1)
Platform
License:MIT License
所有者活动
Created At2014-05-15 19:04:34
Pushed At2024-11-29 15:26:24
Last Commit At2024-11-29 15:26:22
Release Count133
Last Release Namev9.1.1 (Posted on 2024-11-29 15:26:22)
First Release Namev0.0.1 (Posted on 2014-05-17 21:55:24)
用户参与
Stargazers Count1.7k
Watchers Count14
Fork Count151
Commits Count1k
Has Issues Enabled
Issues Count272
Issue Open Count26
Pull Requests Count7
Pull Requests Open Count0
Pull Requests Close Count5
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private