Links

Links are the heart of Confluence, so learning how to create them quickly is important.

Notation Comment
[#anchor]
[^attachment.ext]
or
[pagetitle]
[pagetitle#anchor]
[pagetitle^attachment.ext]
or
[spacekey:pagetitle]
[spacekey:pagetitle#anchor]
[spacekey:pagetitle^attachment.ext]
Creates an internal hyperlink to the specified page in the desired space (or the current one if you don't specify any space). Appending the optional '#' sign followed by an anchor name will lead into a specific bookmarked point of the desired page. Also having the optional '^' followed by the name of an attachment will lead into a link to the attachment of the desired page.

Example: pagetitle

If such a page doesn't already exist, it will allow you to create the page in the current space. Create page links will have a after them.

Example: anewpage

[link alias|#anchor|link tip]
[link alias|^attachment.ext|link tip]
or
[link alias|pagetitle|link tip]
[link alias|pagetitle#anchor|link tip]
[link alias|pagetitle^attachment.ext|link tip]
or
[link alias|spacekey:pagetitle|link tip]
[link alias|spacekey:pagetitle#anchor|link tip]
[link alias|spacekey:pagetitle^attachment.ext|link tip]
Creates an internal hyperlink to the specified page in the desired space (or the current one if you don't specify any space) where the link text is different from the actual hyperlink link. Also you can have an optional link tip which will apear as tooltip. Appending the optional '#' sign followed by an anchor name will lead into a specific bookmarked point of the desired page. Also having the optional '^' followed by the name of an attachment will lead into a link to the attachment of the desired page.

Example: link alias

[/2004/01/12/My Blog Post] [spacekey:/2004/01/12/My Blog Post] Creates an internal hyperlink to the specified blog post in the desired space (or the current one if you don't specify any space). You must specify the date the post was made in /year/month/day form as shown. Anchors and link text can be added the same way as described above.

If you attempt to link to a blog post that doesn't exist, no link will be created.

Example:

[/2004/01/12]
[spacekey:/2004/01/12]
or
[my link name|/2004/01/12]
[my link name|spacekey:/2004/01/12]
Creates an internal hyperlink to a view of a whole day's news. Specify the date you wish to link to as year/month/day. Link titles can be supplied as with other links. It is possible to link to days with no news items on them: the destination page will just be empty.

Examples:

[$12345]
or
[my link name|$12345]
Creates a link to a piece of content by its internal database ID. This is currently the only way to link to a mail message.

Examples:

[spacekey:]
[custom link title|spacekey:]
Creates a link to the space homepage, or space summary page of a particular space. Which of these the link points to depends on the configuration of the space being linked to. If the space does not exist, the link will be drawn with a strike-through to indicate it is an invalid space.

Examples:

[~username]
[custom link title|~username]
Creates a link to the user profile page of a particular user. By default, will be drawn with a user icon and the user's full name, but if you supply a custom link text, the icon will not be drawn. If the user being linked to does not exist, the link will be drawn with a strike-through.

Examples:

[phrase@shortcut]
[custom link text|phrase@shortcut]
Creates a shortcut link to the specified shortcut site. Shortcuts are configured by the site administrator. You can add a link title to shortcuts in the same manner as other links.

Examples:

[http://confluence.atlassian.com]
[Atlassian|http://atlassian.com]
Creates a link to an external resource, special characters that come after the URL and are not part of it must be separated with a space. External links are denoted with an arrow icon.

Note: the [] around external links are optional in the case you do not want to use any alias for the link.

Examples:

[mailto:legendaryservice@atlassian.com] Creates a link to an email address, complete with mail icon.

Example: >>legendaryservice@atlassian.com

[file://c:/temp/foo.txt]
[file://z:/file/on/network/share.txt]

This only works on Internet Explorer
Creates a link to file on your computer or on a network share that you have mapped to a drive

{anchor:anchorname} Creates a bookmark anchor inside the page. You can then create links directly to that anchor. So the link [My Page#here] will link to wherever in "My Page" there is an {anchor:here} macro, and the link [#there] will link to wherever in the current page there is an {anchor:there} macro.