这几天事一直很多，肝了几天终于完成的差不多了。这才有时间去写 Apicon。 这次想聊聊 Apicon 里的一个核心的功能——API 文档的编辑与展示。我最初的想法是，像助手一样按照一定的格式，使用 Markdown 来编写文档。但是这样在格式上难免不好统一。跟副主席聊的时候，他向我推荐了 Swagger 和 API Blueprint。这两个都是 API 文档自动生成工具。对比过后，我决定选择