Defect #19880


Incorrect syntax for links in Markdown

Added by Anonymous about 9 years ago. Updated almost 3 years ago.

Text formatting
Target version:
Start date:
Due date:
% Done:


Estimated time:
Wont fix
Affected version:


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.


common_mark.png (44.6 KB) common_mark.png Marius BĂLTEANU, 2021-08-12 22:57

Related issues

Related to Redmine - Feature #32424: CommonMark Markdown Text FormattingClosedMarius BĂLTEANU

Actions #1

Updated by Jean-Philippe Lang about 9 years ago

  • Status changed from New to Needs feedback

Please, give an example that illustrates the issue.

Actions #2

Updated by Anonymous about 9 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. :)

Actions #3

Updated by PICCORO LenzMcKAY about 9 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..

Actions #4

Updated by Toshi MARUYAMA almost 9 years ago

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

Updated by T H over 8 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]”.

Actions #6

Updated by T H over 8 years ago

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

Actions #7

Updated by Jan from Planio over 4 years ago

  • Related to Feature #32424: CommonMark Markdown Text Formatting added
Actions #8

Updated by Marius BĂLTEANU almost 3 years ago

I'm closing this as "Won't fix" because the new CommonMark formatter available in Redmine 5.0.0 (#32424) correctly renders the link. The current Markdown implementation based on RedCarpet is deprecated and it is going to be dropped in the future versions. Migrating to the new CommonMark Markdown (Github Flavoured) engine is recommended.


Also available in: Atom PDF