Defect #19880

Incorrect syntax for links in Markdown

Added by Anonymous almost 6 years ago. Updated about 5 years ago.

Status:NewStart date:
Priority:NormalDue date:
Assignee:-% Done:


Category:Text formatting
Target version:-
Resolution: Affected version:2.6.4


As per the standard Markdown syntax:

To create an inline link, use a set of regular parentheses immediately after the link text’s closing square bracket.

The alternative link syntax style allows two sets of square brackets to be used, the first as the link text and the second as a reference to a link stored elsewhere in the document. In this case only:

You can optionally use a space to separate the sets of brackets.

It's important to note that this "optional space" behaviour does not apply to the []() syntax.

This was discovered with a long series of links in bullet format, where I had a link pointing to wiki pages as "[target-page#target-anchor|Cool Text]", with a note in brackets after it that turned my entire wiki page link string into a label and broke the link.

Note: I have not tested this in the latest 2.x or 3.x versions, but I also couldn't find any existing issue reports that cover this problem.

Related issues

Related to Redmine - Patch #32424: CommonMark Markdown Text Formatting New


#1 Updated by Jean-Philippe Lang almost 6 years ago

  • Status changed from New to Needs feedback

Please, give an example that illustrates the issue.

#2 Updated by Anonymous almost 6 years ago

Apologies, that would have been a good thing to include from the start. This editor is set to use Textile, but try the following in the Markdown editor:

[this should be a link](
[this should not be a link] (

Everything else with the link syntax appears to be fine, it's just this one. :)

#3 Updated by PICCORO LenzMcKAY over 5 years ago

i found a problem using the markdown sintax..

when formatting a added links using the format bar.. the links changed and putting using "[[]]" so when i push "save" redmine crash...

i lost the logs and installation due i not visit that issue report..

#4 Updated by Toshi MARUYAMA over 5 years ago

  • Category set to Text formatting
  • Status changed from Needs feedback to New

#5 Updated by T H about 5 years ago

This also applies to links into the wiki. I discovered this bug report because I wanted to include a comment to a ticket like so:

… this is a ticket which is discussed in our wiki on page [[whatever the page]] (only for developers).

Redmine incorrectly interprets this as a link to URL “only for developers” with the link text being “[whatever the page]”.

#6 Updated by T H about 5 years ago

BTW, this also affects version 3.1.3-stable. (That’s the version we’re on.)

#7 Updated by Jan from Planio over 1 year ago

  • Related to Patch #32424: CommonMark Markdown Text Formatting added

Also available in: Atom PDF