1. Bitbucket
  2. Public Issue Tracker
  3. master
  4. Issues


Issue #6775 new

Easier linking to another wiki page from Markdown (BB-7954)

Dmitry Pashkevich
created an issue

Please support one or both of the following syntaxes for easier linking between internal wiki pages when using Markdown:

  • [[Page name]] (Creole-style)
  • [Page name]() (Techically an empty link in markdown but makes sense to link to a wiki page with specified title)

Currently I there seems to be no way of linking to a wiki in Markdown without duplicating page name:

[Page name](Page name)

Comments (14)

  1. Jez Hill

    Mike Chaberski Yes, that's the good news, which I subsequently discovered. (When I first tried, I thought [[this]] didn't work, but I guess I must have been doing something else wrong.) I wish, though, that there were a way of getting the best of both worlds, i.e. [renaming a link on the page](like this) but in a wikilinks-compatible way—for example using [[the way mediawiki does it | piped link syntax]]. AFAICS the latter does not work, nor have I found any working alternative syntax. I find this constrains the style in which you can write doc.

  2. Henry Umansky

    The syntax Mike Chaberski recommends doesn't work for me. It looks like it "almost" works, except that it prefixes a commit hash to the URL path for the wiki page.

    For example, this text [[IssueTracker]], converts to the following link in my wiki, comments, or issue tracker:


    It would be nice to be consistent throughout BitBucket, so that the wiki, comments, and issue tracker all have the same markdown syntax.

  3. Charlie Turner

    Completely agree with the above two commenters. Just burned 30 minutes of time puzzling over that, since I didn't want to commit my changes when the preview button was showing me something was going wrong....

  4. Log in to comment