Using links in documentation - problem with ampersand sign

(Arie Gofer) #1

I am trying to include a link in my documentation (i.e. under “description” tag).
something like:

[click here] (

indent preformatted text by 4 spaces
From some reason, when I view this link in “read” perspective (and on the final published hub), the & sign is escaped and the link becomes
which is totally different and therefore I cannot link to the document I actually meant to.

any suggestions?

(Chris Lott) #2

This looks like a bug on our end. I’ve opened an issue in our public GitHub repo so you can track the progress:

(Arie Gofer) #3

Thanks !
Is there a better way to include “download swagger file” link or button within a documentation page ?

(Brian) #4

This fix is scheduled for the next release near the end of January

(Taylor Barnett) #5

Hey @agofer, I forgot to follow up on this when the fix came out for it a couple of weeks ago. Can you confirm it looks :+1: on your end? Thanks!

(Arie Gofer) #6

@taylor works like charm now. thanks for following up!
That said - I consider it as a workaround till we have a better solution for Allow users to download swagger file as it still requires to be logged into the editing system.
Any updates on this issue?

(Taylor Barnett) #7

I’ll jump over there with an update, so anyone following it can see it too.

(Taylor Barnett) #8