告别手写,使用 Doc View 快速生成接口文档

Doc View 是一款快捷生成接口文档 IDEA 插件,使用 Doc View 可以将开发人员从繁琐的文档编写中释放出来,极大的节省开发时间。

Doc View 支持以下功能:

  • Controller/Dubbo 接口生成 Markdown 文档
  • 查看 Markdown 源码,预览 Markdown, 编辑接口字段等
  • 支持自定义配置 Markdown 模版
  • 导出 Markdown 文件到本地
  • 上传到 YApi、ShowDoc、语雀
  • 文档目录查看、操作、导出
  • 导航栏 Icon 快捷操作
  • 生成 Http Client

看着这么多功能,是不是很想下载试一试,可以在 IDEA plugin 搜索 Doc View 进行安装。

下面简单介绍下几个常用的功能。

1生成文档

alt

可以通过在右键菜单或者点击左侧导航栏的M 进入展示界面。

界面可以:导出全部、上传全部、预览、查看 MD 源文件、编辑、单文件上传等。

alt

其中上传支持 YApi、ShowDoc、语雀

2文档目录

alt

在右侧窗口支持查看当前项目的所有接口文档列表,按照 Module、Class 树状排列。

Open:生成 Markdown 源文件

Http Client:生成 Http Client 文件

Markdown 源文件
Markdown 源文件
Http Client
Http Client

其中 Markdown 文件可以利用 IDEA 导出 Docs、PDF、HTML,Http Client 文件稍微调整则可以直接运行发起 Http 请求。

3配置模版

alt

在设置窗口,可以设置模版,只要保留占位字段,其他内容可以任意调整,比如将 **接口名称:** 替换为 ### 接口名称:

alt

除此之外,也支持其他配置,更多的则需要小伙伴自己摸索啦。

4最后

插件是开源在 GitHub,有兴趣小伙伴可以看一下,也欢迎提交 PR。

GitHub:https://github.com/liuzhihang/doc-view

插件文档是放在语雀,方便留言、划词留言等,也欢迎共同维护。

说明文档:https://www.yuque.com/liuzhihangs/doc-view

在说明文档中有更详细的使用哦!

alt

感谢:lvgo、知一、大斌、liaozan、ayang0422 等等小伙伴的参与。

本文由 mdnice 多平台发布

  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

程序员小航

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值