之前内部前后端文档都是用 swagger 、yapi 之类的。现在要给一些对外的接口文档，但是是通过 PDF 的形式给出而不是提供一个 Web 平台，而且这个 PDF 内容的结构和格式都要求比较严格，所以都是先写一份 word ，再转成 PDF 。如果遇到参数是 object 的结构，参数表格里面要体现这种嵌套层级的关系感觉就比较麻烦了，缩进、合并单元格之类的领导都觉得不太美观，所以就比较犯难，不知道各位有没有比较好的例子和建议可供参考
请不要在回答技术问题时复制粘贴 AI 生成的内容
This topic created in 1413 days ago, the information mentioned may be changed or developed.
 | 1 Jooooooooo Jul 19, 2022 合并单元格都不美观还要啥... 直接一个大 json? |
 | 2 murmur Jul 19, 2022 List<Next 嵌套的 Object>，Next 嵌套的 Object 单独在出一节文档，以此类推，每次嵌套都定义一各新对象 |
| 3 murmur Jul 19, 2022 比如 Form 、FormField 、FormFieldOptions 这样 |
 | 4 MoYi123 Jul 19, 2022 抄阿里云的接口文档格式就行了, 领导觉得有问题就让他看阿里云是怎么做的. |
 | 5 Tsukihime Jul 19, 2022 习惯用 markdown 写，再转 PDF ，markdown 里面贴 JSON 不乱 |
 | 6 lower Jul 19, 2022 object 参数的说明，备注详情请参考下文 xxx ，或者附录 xxx ，直接底下新起一段说明和 object 内部参数表格说明； 最后，在展示一个完整示例 json |
 | 7 Elietio OP  我也参考了市面上的一些例子，做了三个样式，但是领导觉得都不行。。。 |
 | 11 FYFX Jul 19, 2022 我以前写法就是每个对象都是一个表格，然后就一堆小表格 |
 | 12 chavyleung Jul 19, 2022 如 #6 说的，腾讯 serverless 就是这么干的 https://github.com/serverless-components/tencent-http/blob/master/docs/configure.md |
 | 13 ktqFDx9m2Bvfq3y4 Jul 19, 2022 面向领导编程，惨，无语。 |
 | 14 fgwmlhdkkkw Jul 19, 2022 图片怎么样…… |
 | 15 storyxc Jul 19, 2022 还好我领导没这么多屁事 |
 | 16 unco020511 Jul 19, 2022 每个 object 节点是一个表格 |
 | 17 akira Jul 19, 2022 需要嵌套的地方 单独拎出来写 |
 | 18 grissom Jul 19, 2022 领导提的让领导出模板 |
 | 19 Jinnyu Jul 20, 2022 | 参数名称 | 参数类型 | 参数说明 | 备注 | | :--------------- | :--------- | :----------- | :-------------------------------------------------------- | | code | String | 接口响应码 | 完整响应码见[附录 1](#附录 1-短信服务状态码) | | msg | String | 接口响应信息 | 接口返回信息, 可通过本字段排查问题. | | data | JSONObject | 接口响应数据 | | | data\.sequenceId | String | 流水号 | 短信服务业务流水号(22 位)<br>后续可根据流水号查询发送状态. | |
 | 20 siweipancc Jul 20, 2022 via iPhone 嵌套的应该是 obj ，锚点到另一张表 |
Select Language