官方文档地址：https://developer.apple.com/library/mac/documentation/Xcode/Reference/xcode_markup_formatting_ref/ComentBlock.html

找这个找得好苦啊。一言不合先上个图

使用的是Markup的语法

/**

     This method is to add a keyboard to Viewcontroller's view<br/>

     使用此方法添加一个键盘到视图控制器的view上

     - parameters:

        - keyboardFrame: The keyboard's frame   键盘的frame

     */

之前看的都是12年13年14年的文章，之前苹果用的好像是什么 reStructuredText，具体我也不太清楚，不过我想说的是

http://nshipster.cn/swift-documentation/

这篇文章已经过期了。