ShowDoc

showdoc.com.cn又名 Showdoc

面向 IT 研发团队的在线文档工具,可在网页上分块编写 API 文档、数据字典和技术规范,支持团队权限协作与从代码注释自动生成文档,另有可自部署的开源版,适合后端与前端、外部合作方之间反复传阅同一份接口说明。

工具有免费版网页中文开源国内可直接访问

ShowDoc 首页截图

ShowDoc 是一个给技术团队写文档的在线工具。后端写接口、前端对接、测试查参数,这些场景里同一份 API 说明往往要反复传阅,它把这些内容集中到网页上编辑和查看。除了 API 文档,也能用来写数据库的数据字典、工具说明书和技术规范。

主要功能

编辑方式是网页上的富文本与 Markdown 编辑,写接口时按路径、请求参数、返回示例分块填写,出来的页面排版整齐,方便直接发给对接方。数据字典用来描述数据库表结构,说明文档则适合放规范、流程这类需要团队长期查阅的内容。

  • 团队权限管理,多人协同编写同一批文档
  • 可从代码注释自动生成文档
  • 搭配 RunApi 客户端调试接口,并自动生成文档

托管与开源

官方提供在线托管服务,文档数据放在云端;同时有免费开源版本,可以部署到自己的服务器上,适合对数据存放位置有要求的团队。页面上标注平台已稳定运行 3996 天,托管文档数超过一千万,服务用户超过五十万。

适合谁

主要面向有接口对接需求的研发团队,尤其是后端与前端、外部合作方之间需要共享接口说明的场合。页面提到腾讯、百度、华为、字节跳动、顺丰等团队在使用。如果只是个人记笔记,功能会偏重;团队规模小、文档量不大时,用普通文档工具也能应付。

常见问题

ShowDoc 收费吗?
ShowDoc 有免费版,部分功能或用量要付费。提供免费开源版,可自行部署;在线托管价格未注明。
ShowDoc 国内能访问吗?
本站 11 月 8 日 检测,ShowDoc 在国内可以直接访问。
ShowDoc 有哪些平台 / App?
支持 网页。
ShowDoc 的替代品有哪些?
本站整理了 2 个替代品,例如 语雀、AppFlowy。

替代品 全部 2 个 →

收录于 2024 年 11 月 · 更新于 11 月 8 日 · 本站 11 月 8 日 检测 · 浏览 412 · 报告问题

替代品 2 个打开官网showdoc.com.cn