How do I link things up?

Markdown allows us to easily any link text to anywhere. The link text is delimited by [square brackets], and the link URL is delimited by (round brackets).

To create an inline link, use a set of regular parentheses immediately after the link text’s closing square bracket. Inside the parentheses, put the URL where you want the link to point, along with an optional title for the link, surrounded in quotes. For example:

This is [an example](http://example.com/ "Title") of an inline link and [this link](http://example.net/) has no title attribute set.

Relative and absolute links

This is an absolute link to [Tank](http://withtank.com/) and this is a relative link to [our support section](/support/).

Automatic links

There is a shortcut style for creating automatic links for URLs and email addresses: simply surround the URL or email address with angle brackets. What this means is that if you want to show the actual text of a URL or email address, and also have it be a clickable link, you can do this:

<http://withtank.com/> results in http://withtank.com/ <support@withtank.com> results in support@withtank.com

Please note you are required to fully demarcate the URL: in other words omitting 'http://' will not result in anything:

<www.withtank.com/> will not work

'Mailto' links

You can mix in mailto should that be required:

[contact us](mailto:support@withtank.com) results in contact us

Unique internal links

All content within Tank also generates its own unique internal link which you might have noticed while you are editing sections or content. Simply copy and paste these internal links to other areas in your site in order to link your content together.

This is an example of the unique internal link for the content you are reading now: [How do I link things up?](#pod_45cab58afd#). You will notice it follows a similar style as above with a hashed url - #pod_45cab58afd# - in between the round brackets.

The nice thing about these unique internal links is that they will never break even if you change the name of the page, post or album they refer to.

Mixing in HTML

The hashed url can also be used inside regular HTML if you prefer:
<a href="#pod_45cab58afd#">How do I link things up?</a>

This can also be expressed as a relative link:
<a href="/support/managing-content/how-do-i-link-things-up/">How do I link things up?</a>

Why use unique internal links?

Your content is constantly changing, and when you change content the links to that content changes. If you use unique internal links you can be sure that there are no broken links on your site, unless of course you delete the content it was linking to in the first place.