star7th

你看系统生成的api文档示例，就按照那种写法。公共说明放在根目录页面。具体每个接口，放在文件夹里。 Jimmy0806 ***@***.***>于2022年6月24日 周五上午11:59写道： > > showdoc不鼓励你这种用法。要写多个接口文档，请善于使用showdoc本身的目录功能。你这样企图把整个项目都放在一个页面里是不合理的。合理情况下使用，右侧标题目录不会有那么多层级。 > showdoc自带的目录是文件夹形式的，文件夹下放置的页面也是平级的，只有多个文件夹才是分级的，但是文件夹不适合设置类似截图的那样目录层级效果哦 > > — > Reply to this email directly, view it on GitHub > , > or unsubscribe > > ....

markdown编辑器会把换行符翻译为换行，所以输入html标签的时候，标签与标签之间不要包含换行，会被转义为br换行或者p段落。

要判断标签然后去掉标签之间的换行符，这玩意需要探索一下，也许需要正则匹配。我有时间再看下

曾经有段时间好像设置过编辑快捷键是ctrl +e ，后来忘记什么原因取消了。

https://github.com/star7th/showdoc/issues/1710

https://github.com/star7th/showdoc/issues/1481

github获取用户信息的接口是对的吗，返回的格式，你找一下文档看对不对

我自己没有去测试。但showdoc接入的，应该符合标准oauth2协议

好像文档里，github https://api.github.com/user 是需要把认证参数放到header里去的。而showdoc请求接口的时候是使用get传递参数的。我不明白为啥github只支持这种写headre方式，其他认证服务器都没问题。或者，是否存在别的接口是支持get参数方式的。

后面有时间再加一下。