求推荐比较好用的接口文档管理工具？

[zhuwd]

主要有两个场景：1.团队内部使用； 2.接口文档导出给第三方对接平台

[iamfei666]

语雀

[dayeye2006199]

注释

[yekern]

Apifox 或者 Apipost 直接调试 然后网页访问文档 还能加密

[THESDZ]

个人建议是找个支持 openapi(swagger3)导入的框架

[THESDZ]

@THESDZ
优势是：1.代码即文档，减少工作量。2.标准格式外部工具很多，例如导出 word ，pdf ，markdown ；生成 sdk 等。

[mengdodo]

showdoc

[oyp]

直接手写 Word

[waising]

手动录入 yapi

[oyp]

我用 wolai 编辑 API 文档，不用想那么多，写起来贼流畅。虽然不能直接运行（我手动运行一样的）和不能自动生成结构（把返回的数据粘贴过去，看 JSO 也能看出来，没必要生成）

图 1：s3.bmp.ovh/imgs/2022/06/28/7334b6845b8fd612.png
图 2：s3.bmp.ovh/imgs/2022/06/28/7e83681e49b8c241.png

[xuxuzhaozhao]

非常推荐使用 ApiPost

[DavidDee]

yapi,rap2

[jmllx1963]

apifox 可以通过 URL 直接导入 openAPI3 的接口和数据模型 还是很方便的

[abc0123xyz]

别写什么文档注释，提高竞争力，防止被优化（狗头）

[carrie96]

yapi ？ swagger ？

[d119]

postman 不也可以吗

[linauror]

个人目前用的比较爽的是用注释导出 swagger ，然后 yapi 自动定时同步 swagger.json （手工导入会导致结构错乱，不知道咋回事）

[ychost]

ApiPost 好用，还能一键生成 HTML/Markdown 文档，唯一不爽的就是老是在更新！

[flowerains]

Apifox ，apiPost

但是从团队协作的程度上来看我觉得 eolink 更有潜力

[wolfie]

showdoc ，导出不太方便（可能版本问题）。/t/842583

_都不用 ApiPost ，可以搜一搜过去在 v2 上的恶心推广。

[balabalaguguji]

不废话，看效果先： https://easydoc.net/s/17790664/CZMqMhfW/78558034
还可以做手册，自定义域名，看效果： https://k8s.easydoc.net

官网： https://easydoc.net