Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Does Confluence support markdown TOC coding?

We have imported a markdown document into confluence.

The standard coding for a TOC  is not working. We are using this:


* Topic 1 (#topic1)

* Topic 2 (#topic2)


## Topic 1 <a name="topic1"></a>


## Topic 2 <a name="topic1"></a>



1 answer

Hello Ward,

Welcome to Atlassian Community. It's nice to meet you!

You can insert markdown into a page directly, and Confluence will convert it. Have a look at Confluence Wiki Markup for information on how you can use wiki markup or markdown in Confluence.

Note that you will not be able to include the markdown into a Word document, for example, and import that into a page. This feature was removed along with markup support in Confluence 4.0.

I hope that helps, but let me know if you have any questions.



Thanks Shannon. 

We've got our markdown-coded doc into confluence and it formats nicely. The problem is the TOC coding is not working or accepted by confluence. 

Our heading 2 renders like this when viewed in confluence:

Requirements <a name="requirements"></a>

When you click the relevant TOC entry at the top of the file:

* Requirements (#requirements)

The browser displays a blank page. I'm guessing this coding (in bold, above) is not supported.


Just to confirm - the markdown was entered directly into Confluence, and not imported using the Word importer? Please let us know how you got the markdown into the document, and can you show me how it looks on the page?

Edit to add: the markdown that should work is on this page: Confluence Wiki Markup

You can see the Markdown Syntax Guide for information on what markdown you can use. In terms of your example, the <a name= should not render.

Thank you for your help.



Suggest an answer

Log in or Sign up to answer
Community showcase
Posted in Confluence Cloud

Please tell us how you use Confluence space settings

👋 Hi there, a few of us at Atlassian would love to learn about how you use "space settings" functionality in Confluence. A facelift to the space settings is long overdue and we want to start with im...

567 views 15 9
Join discussion

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you