The Anchor Macro allows you to link to specific parts of a page. Anchor links can be especially useful when navigating between sections of a long document or when you want to link to a segment of a page and not to the page as a whole.
The Anchor Macro allows you to link to specific parts of a page. Anchor links can be especially useful when navigating between sections of a long document or when you want to link to a segment of a page and not to the page as a whole.
Anchors are invisible to the reader when the page is rendered.
Anchors are made up of two parts:
On this page:
To insert the anchor macro into a page using the Macro Browser,
|
Once you've found the anchor macro, click 'insert' to add it to your page. |
The following code creates an anchor called "here", but you can substitute this with whatever name you like.
{anchor:here}
|
Once an anchor is in the page, you can link to it by putting #here (or whatever anchor name you choose) at the end of a link pointing to that page.
Parameter |
Default |
Description |
|---|---|---|
Anchor Name |
None; name must be supplied |
This is the name of the anchor that you will link to. |
In the next example, there are two anchors in this page called "top" and "bottom", which you can link to like so:
[#top] [#bottom] |
These links come out like this: top bottom.
More examples follow.
Linking to an anchor in the same page
[#anchorname] |
Linking to an anchor in another page
[nameofpage#anchorname] |
Linking to an anchor in a page in another space
[spacekey:nameofpage#anchorname] |
Linking to headings
Confluence treats all headings as anchors. So you don't have to place an anchor but simply link to it like this:
[#textofheading] |
Page titles and links to other spaces can be combined with anchors and attachments, but you can't use attachments and anchors in the same link. |
Note that if you are adding an anchor to the site welcome message, it must be to another page. Internal-only links such as {anchor:bottom} will not render.
Take me back to the Confluence User's Guide.