介绍
esdoc-standard-plugin 是一个用于生成 JavaScript 文档的 ESDoc 插件。该插件使用了 StandardJS 规范，并支持 Markdown 格式的文档注释，可以帮助开发者快速、方便地生成高质量的文档。
安装
首先，您需要在项目中安装 ESDoc：
npm install --save-dev esdoc
然后，安装 esdoc-standard-plugin：
npm install --save-dev esdoc-standard-plugin
配置
在项目的根目录下新建 .esdoc.json 文件，并添加以下内容：
{
"source": "./src",
"destination": "./doc",
"plugins": [{
"name": "esdoc-standard-plugin"
}]
}其中，source 表示源代码目录，destination 表示文档输出目录，plugins 表示使用的插件列表，本文介绍的是 esdoc-standard-plugin。
如果您的项目中还有其他插件，可以将它们一并加入到 plugins 列表中。
使用
在源代码文件中，可以使用类似如下的 Markdown 格式的注释来生成文档：
-- -------------------- ---- ------- --- - -------- - - ------ -------- - - ----- - ------ -------- - - ----- - -------- -------- ------ -- -------- --- --- -- - ------ - - - -
然后，在命令行中执行以下命令，即可生成文档：
./node_modules/.bin/esdoc
示例代码
以下是一个使用了 esdoc-standard-plugin 的示例项目：https://github.com/example/esdoc-standard-plugin-example。您可以参考该项目中的配置和注释来学习如何使用该插件生成文档。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/47259