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
Answer accepted
Jeff Thomas Atlassian Team Jun 07, 2017

Hi Pavel,

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


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 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](


# Configuration

For me it works like this:


The difference between the above and the solution proposed by @Hajaniaina R (web) is that I am omitting the

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


What I did let the 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)


This is the one, folks! Nice one, Konstantin.

0 votes

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

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 14, 2019 in Bitbucket Pipelines

Building a Bitbucket Pipe as a casual coder :  #!/bin/bash source "$(dirname "$0")/" enable_debug extra_args="" if [[ "${DEBUG}" == "true" ]]; then extra_args="--verbose" fi # mandatory variables R...

278 views 0 12
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