| 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 dont 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 doesnt 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 dont 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 dont 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 doesnt 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 days 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 users 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.
|
{redirect:Page Name}
{redirect:SPACE:Page Name|delay=10}
{redirect:http://www.somewhere.com/}
|
Redirects the browser to the specified page or URL.
Note: To allow editing of a page once it has been redirected,
add '?redirect=false' to the query string.
- [default] - (required) The page or URL to redirect to.
- delay - (optional) The number of seconds to delay before redirecting.
|
{alias:Alternate Name}
{alias:Alternate Name|parent=Another Page}
{alias:Alternate Name|parent=@parent}
|
Creates an alias for the current page. Any references to the alias will be redirected
to this page.
- [default] - The alias. Must follow standard page naming conventions.
- parent - (optional) The parent the alias should have. May be set to any page
in the current space. It will default to having no parent.
It may also be one of two special parent markers:
- @self - the parent will be the page being aliased.
- @parent - the parent will be the parent of the page being aliased.
|
|
{add-page:template=My Template|parent=Page Parent}Click to add page{add-page}
|
Generates an 'Add Page' link which, when clicked, can take the user directly
to a template and/or set the page parent.
- template - (optional) the name of the template to use when creating the page.
- boilerplate - (optional) the name of the template to use as a boilerplate when creating the page.
(requires the Scaffolding Macros to work correctly)
- parent - (optional) the name of the parent page (empty by default).
May also have the following markers:
- @self - the parent will be the page the macro is in.
- @parent - the parent will be the parent of the page the macro is in.
- @home - the parent will be home page for the Space the page is in.
- title - (optional) if you want popup text to appear when the mouse is hovered
over the link, enter it here.
|
{link-to:dashboard}Go to Dashboard{link-to}
{link-to:news|space=ANOTHERSPACEKEY}Go to another space's news{link-to}
{link-to:page source|popup=true}View page source{link-to}
|
Creates a link to special Confluence locations. All locations are non-case-sensitive.
Parameters
- [default] - The location to link to. See the list of locations below.
- space - (optional) The spacekey to link to.
- page - (optional) The name of the page to link to
- popup - (optional) If
'true', the link will open in a popup window.
- target - (optional) The name of the popup window to open.
- title - (optional) if you want popup text to appear when the mouse is hovered
over the link, enter it here.
Global Locations
- admin - The administration section.
- dashboard - The Dashboard.
- global templates - The global templates page.
- homepage - The user's homepage.
- login - The login page.
- logout - The logout page.
- notation guide - The notation guide.
- rss feed builder - The RSS Feed Builder (Confluence 2.x)
- spaces - The list of spaces the user has access to. (Confluence 1.4)
- user profile - The currently logged in user's profile.
- user history - The currently logged in user's history.
Space Locations
You can specify which space to link to by setting the 'space=key' parameter,
or it will default to the current space.
- add news - Add a news post.
- browse space - Go to the 'Browse Space' view.
- mail - The mail page.
- news - The news page.
- pages alphabetical - The list of pages in alphabetical order.
- pages tree - The hierarchical view of pages in the space.
- pages updated - The recently updated pages list.
- space attachments - The attachments list for the space.
- space templates - The space templates list.
- popular labels - A page listing popular page labels in the space. (Confluence 2.x)
- all labels - A page listing all labels across the space. (Confluence 2.x)
RSS Feeds
Again, you can specify the space, or the current one will be used as the default.
- rss comments - New comments are added to this feed.
- rss news - News items for the space are added to the feed.
- rss new pages - Any new pages in the space are added to the feed.
- rss updated pages - Any updated pages in the space are added to the feed.
Page Locations
You can specify the space key as above, and you can specify the page with the 'page=Page Name'
parameter.
- @parent - Links to the page's parent, if it has one.
- @self - Links to the page the macro is on.
- add comment - Opens the 'add comment' section of the page.
- page comments - Jumps to the page comments.
- page attachments - The attachments tab for the page.
- page children - Jumps to the page children list.
- page edit - The edit tab for the page.
- page history - The page history view.
- page info - The page info view.
- page source - The page source view
- pdf export - Export the page to PDF.
- print - The print view for the page.
|
{link-page:template=My Template|parent=Page Parent}Click to add page{link-page}
{link-page:Page Title|template=My Template}A Specific Page{link-page}
|
Links to a page in the current space.
If the page doesn't exist or is untitled, it generates a 'Add Page' link which, when clicked, can take the user directly
to a template and/or set the page parent.
- [default]/name - (optional) the title of the page. If not supplied, clicking the link will always create a new page.
- template - (optional) the name of the template to use when creating the page.
- parent - (optional) the name of the parent page (empty by default).
May also have the following markers:
- @self - the parent will be the page the macro is in.
- @parent - the parent will be the parent of the page the macro is in.
- @home - the parent will be home page for the Space the page is in.
- title - (optional) if you want popup text to appear when the mouse is hovered
over the link, enter it here.
|
Links
