Appledoc and custom link description

If I'm doing something stupid, I'm sorry in advance. But I cannot identify my error.

Here is the code (header file):

#import <Foundation/Foundation.h>

/**
 Represents a cover image. It can be a game cover, a trophy image or even a player avatar.

 It has three properties:

 - **NSMutableString uri**: the link that points to the image.
  - E.g.: [A Skyrim trophy image URI] (http://bit.ly/skyrimTrophyImageUri ).

 - **UIImage img**: the actual image. That is, the bitmap.
  - E.g.: 1A9A3826FB6B42C1B08824655A740620BC8E75F9.PNG

 - **ResolutionType resolution**: the image resolution, which comes from an enumeration of this class called __"ResolutionType"__.
  - E.g: SEN_75x41

*/

@interface NHOCCover : NSObject

The result:

enter image description here

I'm following these instructions (at "Custom link descriptions" section).

I also tried:

[A Skyrim trophy image URI] (http://bit.ly/skyrimTrophyImageUri) (without spaces)
[A Skyrim trophy image URI] ( http://bit.ly/skyrimTrophyImageUri ) (with spaces)

Maybe Xcode is messing up with the file? On a second related question, do you know if there is a way to block Xcode from automagically create links in its editor? (I mean to change the font color to blue and underline it).

Thanks in advance.

Solution

Already answered you on github, adding the answer here as well for folks coming to this page: this is known issue with v2, will be fixed in 3.0. See https://github.com/tomaz/appledoc/issues/180