TypeDoc 是一款支持 TypeScript 的文档生成工具。

安装、使用方便。最后生成的是静态的 HTML 文件，界面简洁。

提供多个可选的配置，并且可以按照自己的需求自定义界面样式。

源码地址：TypeDoc

文档地址：TypeDoc Documentation

优雅的使用方式

// 1. 配置到package.json中，其中使用npx命令，无需单独安装typedoc库
// 2. transform.js里可以将目标文档的特殊关键字替换。做一些前置处理

"scripts": {
    "typingsdoc": "node typings/transform.js && npx typedoc --out ./typings/doc  ./typings  --module umd"
},

两个好用的插件

typedoc-plugin-single-line-tags

以上插件可以用一个注解，将描述展示为一行。而非多行，比如一个私有类，可以增加一个@private，然后增加一段说明

typedoc-plugin-external-module-name

当有多个模块，分为不同文件时，可以用上面的插件将模块区分出来。做类似的二级栏目。

关于同一 Module 文档的二级分类

1. 使用上面的插件，按文件区分；
2. 使用这个插件搞定：typedoc-plugin-toc-group

至于插件的开发，请移步这篇文章：

TypeDoc 插件开发小记