Using links in documentation - problem with ampersand sign


(Agofer) #1

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

[click here] (https://a.com?a=1&b=2)

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
https://a.com/?a=1&amp%3Bb=2
which is totally different and therefore I cannot link to the document I actually meant to.

any suggestions?
thanks


(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: https://github.com/stoplightio/desktop/issues/353


(Agofer) #3

Perfect.
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