Request for Documentation: add advanced link formatting info for complex urls

[mm-cloud-bot]

trafficstars

Mattermost user sven.huester from https://community-daily.mattermost.com has requested the following be documented:

You might need to use yet another way of doing Markdown links with the "reference-style" links to hide that fully.

[link text](a)

[a]: https://example.com

[cwarnermm]

@svelle - Can you provide some context for this docs issue, please? Under what circumstances would a user want to use this type of Markdown link, and to achieve what outcome?

[svelle]

Hey @cwarnermm for sure!

So take for example a wikipedia page with parentheses in the url and you want to create a short link for that say Saw Movie Franchise (took this from a reddit example no particular intention :D )

The url looks like this https://en.wikipedia.org/wiki/Saw_(disambiguation)#Films_and_associated_media

A lot of markdown parsers including our own struggle with the parentheses in that URL and will end the custom link before the url is completed resulting in it being cut off to something like this: https://en.wikipedia.org/wiki/Saw_(disambiguation

The example from the opening post will work around that as everything behind the colon is interpreted as the url for [a] which can then be used for the link further up.

So in a real world example it would look like this:

[Saw Movie Franchise](a)
[a]: https://en.wikipedia.org/wiki/Saw_(disambiguation)#Films_and_associated_media

[Sayanta66]

Can I take this issue? @cwarnermm

[cwarnermm]

Thanks, @Sayanta66! I've assigned this docs ticket to you.

[Sayanta66]

Thanks a ton :)

[cwarnermm]

@Sayanta66 - Are you actively working on this? Would you like to keep it assigned to you?

[Sayanta66]

yup!!! I am still searching on the solutions