Some documentation features not working in Xcode 8

Question

I'm experimented with documentation comments for Swift in Xcode 8 and found that not every feature from Markup Formatting Reference works. In particular, I can't make seealso: callout working and can't insert image URL to my documentation comments.

That's how my seealso: looked like:

I used exactly the same comments as described on these webpages.

Did anybody have the same problem? Does anybody know the solution?

I'm having the same problem with `seealso` but unfortunately no solution yet. — Raginmari, Dec 06 '16 at 09:11
Same behavior! Is [this](https://bugs.swift.org/browse/SR-1161) the official bug report? — Benedikt Reichert, Dec 10 '16 at 21:44
FWIW, I notice that [Jazzy](https://github.com/realm/jazzy/) does honor `seealso`, even if it doesn't in Xcode's quick help. — Rob, Aug 12 '17 at 22:07
Same here, just checked XCode10 Beta doesn't work there either.. — Menno, Jun 05 '18 at 20:16

score 1 · Answer 1 · answered Mar 31 '19 at 14:34

1

Try to update new Xcode. in my experiance work well after delete derived data or clean build press shift+command+K

answered Mar 31 '19 at 14:34

asharijuang

531
5
4

score 1 · Answer 2 · answered Sep 21 '20 at 15:54

1

You can use

# See also
[Link to Google](https://www.google.com)

It's been answered here

answered Sep 21 '20 at 15:54

Pancho

4,099
1
21
32

Some documentation features not working in Xcode 8

2 Answers2