Torna 1.35.6和2.1.20发布 接口文档解决方案

• 单值返回结果的展示逻辑已调整，阅读体验更加清晰；
• 修复了接口名称为空时，对应 Tab 标签意外消失的问题；
• 新增了一项实用功能：点击接口名称可一键跳转到预览页面；
• 文档描述中的 Markdown 格式识别与渲染逻辑也做了改进，不再容易出现异常。

关于 Torna

简单介绍一下，Torna 是一款专注于接口文档管理的工具，核心目标是让团队协作编写文档这件事变得更加顺畅。它支持多人协同编辑与维护，同时兼容多种文档来源，能够把所有接口文档统一归档、集中管控。

与传统的 Swagger 相比，Torna 在保留核心能力的基础上，做了大量实用性扩展，弥补了原生方案在易用性、扩展性和集成性上的不足。下面这张图可以帮您快速建立认知。

直击文档管理核心痛点

在实际工作中，您可能遇到过这些场景：

• 对 Swagger 自带的文档预览和调试界面不太满意；
• 反感侵入式的注解方式，比如 @Api、@ApiOperation 等；
• 更希望基于标准 Javadoc 注释自动生成文档，并支持在线调试；
• 需要将公司内部多个项目的接口文档统一管理；
• 希望向外部合作方开放指定项目文档的只读访问权限，同时避免暴露过多信息；
• 想把项目中涉及的字典、枚举等公共数据结构集中维护，避免各团队各自编写。

如果您正面临上述任意一条挑战，那么 Torna 很可能就是您需要的解决方案。

快速上手指南

推荐技术组合

smart-doc + Torna —— 构建全自动文档闭环体系

如果您是 Java 开发者，强烈推荐尝试 smart-doc + Torna 这一组合。这套方案在全行业已被公认为高效实践——smart-doc 零侵入地解析 Java 源码和 Javadoc，精准提取 API 元信息，随后自动同步到 Torna 这个企业级文档管理平台。

简单来说，您只需编写代码注释，接口文档便会自动生成并实时推送至平台，预览、参数校验、在线调试等流程全部打通。

推送内容涵盖：接口标题 / 作者信息 / 路径参数 / 请求头 / 请求体参数 / 返回结构 / 字典映射表 / 公共错误码列表，基本覆盖日常所需。

如果不是 Java 技术栈也不必担心，Torna 内置了可视化表单编辑器，支持手动录入上述字段，同样提供完整的预览和调试能力。

源码获取地址：立即下载