Project Icon

jsdoc-to-markdown

自动将JSDoc注释生成Markdown格式API文档的工具

jsdoc-to-markdown是一个将JSDoc注释转换为Markdown格式API文档的开源工具。它可从注释中提取函数签名、参数列表和返回值描述,生成格式清晰的Markdown文档。这个工具主要用于自动化API文档生成,简化了开发者在项目README中添加API文档的过程。通过简单的命令行操作,jsdoc-to-markdown能够快速生成标准化的API文档,提高了文档维护效率。

在 npm 上查看 npm 模块下载量 Github 仓库依赖项 Github 包依赖项 Node.js CI js-standard-style

jsdoc-to-markdown

升级用户请阅读发布说明

jsdoc-to-markdown

从带有 jsdoc 注释的源代码生成 markdown 格式的 API 文档。适用于将 API 文档注入到项目的 README 文件中。

概要

1. 使用有效的 jsdoc 注释来编写代码文档。

/**
 * 一个非常棒的函数。
 * @param {object} - 隐私斗篷
 * @param {object} - 安全武器
 * @returns {survival}
 */
function protection (cloak, dagger) {}

2. 运行命令。

$ jsdoc2md example.js

3. 获得 markdown 输出。

## protection(cloak, dagger) ⇒ <code>survival</code>
一个非常棒的函数。

**类型**: 全局函数

| 参数   | 类型                | 描述       |
| ------ | ------------------- | ---------- |
| cloak  | <code>object</code> | 隐私斗篷   |
| dagger | <code>object</code> | 安全武器   |

安装

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

另请参阅

  • API 文档
  • wiki 包含示例输出、常见问题、教程、插件、与 gulp/grunt 等工具的集成使用等内容。

© 2014-24 Lloyd Brookes <75pound@gmail.com>。

test-runner 进行测试。

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

AIWritePaper论文写作

AIWritePaper论文写作是一站式AI论文写作辅助工具,简化了选题、文献检索至论文撰写的整个过程。通过简单设定,平台可快速生成高质量论文大纲和全文,配合图表、参考文献等一应俱全,同时提供开题报告和答辩PPT等增值服务,保障数据安全,有效提升写作效率和论文质量。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号