Markdown internal links support in Bitbucket Server

Is it possible to use internal links in Markdown files?

None of these ways works in version 4.14:
 
[Link Title](#markdown-header-testlink)
[Link Title](#testlink)

some text
........

# Testlink
some text

 

5 answers

1 accepted

3 votes
Accepted answer
Jeff Thomas Atlassian Team Jun 07, 2017

Hi Pavel,

Yes this is possible. In your Markdown create a link at the top:

[link](#section)

and in the body of your document, create the anchor:

<a name="section"></a>

 

Great! It works. Thanks!

This doesn't seem to work in Bitbucket 5.3.2. Is there a different solution for that version?

if you found any solution please tell me :) 

This issue is supposedly fixed in Bitbucket Server 5.3.4 and 5.4.2, but I don't currently have access to either of these versions to verify. See https://jira.atlassian.com/browse/BSERV-10210 for details.

This works for me on v5.11.1 Bitbucket Server.

It is not working for me. It is rendering <a name="target"></a> as text and no navigation. I can navigate with other markdown viewers.

Like 1 person likes this

I am also experiencing the same issue as @Rafael García describes.

Same as Rafael

Functionality still broken!!! :/

Same as Rafael It just shows a text.

We can do something like this

PS: we must add "markdown-header-"  before the id of section

* [Configuration](documentation.md#markdown-header-configuration)

 

# Configuration

For me it works like this:

[Configuration](#markdown-header-configuration)

The difference between the above and the solution proposed by @hajaniain is that I am omitting the README.md

0 votes

Add the text "[TOC]" to the beginning of the document for it to be generated.

The `<a>` tag in the header file did not work in my case (Feb. 2019).

 

What I did let the README.md file rendered as-is and then right-click the corresponding header I wanted to link to, choose inspect from the context menu (I use chrome, choose the similar option in your browser).

 

You will see generated html similar to the following:

<h1 id="markdown-header-your-awesome-header">...

 

Use then this ID tag to link to the header from your code like:

[this is my link](#markdown-header-your-awesome-header)

 

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 06, 2018 in Bitbucket

Upgrade Best Practices

Hello! My name is Mark Askew and I am a Premier Support Engineer for products Bitbucket Server/Data Center, Fisheye & Crucible. Today, I want to bring the discussion that Jennifer, Matt, and ...

1,945 views 7 10
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you