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.