如何同时使用typedoc-plugin-markdown与zod插件优化推断类型的MD展示?
解决TypeDoc同时使用Markdown和Zod插件时生成HTML的问题
问题核心是你分开执行命令时,每次只加载了单个插件——第二次执行typedoc --plugin typedoc-plugin-zod时,并没有同时加载Markdown插件,TypeDoc默认就会生成HTML格式。要同时启用两个插件,得把它们放在同一个命令或配置里:
方法一:单命令同时指定两个插件
直接在一个命令里同时声明两个插件,这样TypeDoc会同时加载它们:
typedoc --plugin typedoc-plugin-markdown --plugin typedoc-plugin-zod
方法二:使用TypeDoc配置文件(更推荐)
创建一个typedoc.json配置文件,在其中指定要启用的插件列表,这样每次执行typedoc命令都会自动加载所有配置的插件:
{ "plugins": ["typedoc-plugin-markdown", "typedoc-plugin-zod"] }
之后只需要运行:
typedoc
额外检查
确保两个插件都已经正确安装到项目依赖中:
npm install --save-dev typedoc-plugin-markdown typedoc-plugin-zod
这样配置后,既能生成Markdown格式的文档,又能让z.infer<typeof AccountResponse>这类类型展开显示具体结构,不会再变回默认HTML。
内容的提问来源于stack exchange,提问作者Camilo Vega
相关产品推荐
相关产品推荐

