Anchors should not be considert by TOC Macro

We've got a nasty issue. A lot of our documentation consists of large pages. For a better navigation within the page, we use a lot of anchors. If one of those anchors is accidently formated as heading, it is also recognized by the TOC-macro.

Problem is:

If you add a link to a heading-formated anchor somewhere on the page and click it, the link points to the TOC listing.


* Write a page with several headings

* Put an anchor somewhere on that page and format it as heading (h1-h6 work fine ... doesn't matter).

* Create a link pointing to that anchor

* Add the TOC-macro on top of the page

* Click the link.

1 answer

0 vote
Thomas Schlegel Community Champion Aug 27, 2012

Hi Dominic,

I don't think that this is an error. The toc-macro lists all the headings in the page. If your anchors are headings, the macro is doing its job fine.

The other way round: if someone creates a heading as an anchor intentionally. How would you explain him / her that this heading is not shown in the toc ?



Suggest an answer

Log in or Join to answer
Community showcase
Jason Wong
Published yesterday in Agility Beta

Welcome to agility

Every team in the world is unique, and so   Atlassian believes   that each and every team's best way of working  needs to  be molded to their unique circumstances  – ...

333 views 6 15
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot