showdoc - 国产API接口在线文档工具
ShowDoc是什么
ShowDoc是一个非常适合IT团队的在线API文档、技术文档工具。通过showdoc,你可以方便地使用markdown语法来书写出美观的API文档、数据字典文档、技术文档、在线excel文档等等。如果不想编辑markdown文档,你还可以利用showdoc的自动化能力,从程序注释中自动生成API文档,或者从搭配的RunApi客户端(类似postman的api调试工具)中一边调试接口、一边自动生成文档。通过分配项目成员和团队成员,你可以很方便地进行项目文档的权限管理和团队协作,也可以分享文档出去给朋友查看。ShowDoc还支持多平台客户端,有win客户端、mac客户端、ios、android等,更方便跨平台使用。目前超过100000+的互联网团队正在使用showdoc,包括知名公司内部的一些团队,比如腾讯、华为、百度、京东、字节跳动等等。
它可以用来做什么
-
API文档( 查看Demo)
- 随着移动互联网的发展,BaaS(后端即服务)越来越流行。服务端提供API,APP端或者网页前端便可方便调用数据。用ShowDoc可以非常方便快速地编写出美观的API文档。
-
数据字典( 查看Demo)
- 一份好的数据字典可以很方便地向别人说明你的数据库结构,如各个字段的释义等。
-
说明文档 ( 查看Demo)
- 你完全可以使用showdoc来编写一些工具的说明书,也可以编写一些技术规范说明文档以供团队查阅
二次开发
注意:二次开发后请尊重开源协议,保留版权标识和链接
技术栈说明
前端:Vue + ElementUI
后端:为了兼容低版本的 php 运行环境(兼容至 5.3),使用的是保守的 ThinkPHP3.2.3 框架
数据库:ShowdDoc 自带文件型数据库( /Sqlite/showdoc.db.php ),不需要用户手动安装数据库
项目地址
官网:https://www.showdoc.cc/
GitHub:https://github.com/star7th/showdoc