Internet references or short “links” are the binding fabric of the web. Markdown encourages their use by providing simple markup options.

The easiest way to create a link is to write the reference directly into the text and let it be handled automatically. If we want to name a link, we need to connect the name with the reference.

A reference to your own website is called an internal link, a reference to another an external link.

Syntax

A URL (Uniform Resource Locator) starting with http:// or https:// is automatically transformed into a link by the linkify extension. If you want to stop this default behavior, you can set linkify to false in the configuration.

There are two ways to include links from a word or phrase:

  1. You can include them inline within the text.
  2. They may also be written in a separate reference like a footnote.

Automatic links

We can surround URLs for better legibility in the markdown file
with angle brackets <>. The result is the same:

http://www.example.com or <http://www.example.com>
are linked automatically to
http://www.example.com or http://www.example.com.

The link inside of the text has to be enclosed by square brackets [] and the
URL and the optional title follow directly afterwards in parens ().

Examples

- [This is an inline-style link](https://www.google.com)
- [This is an inline-style link](https://www.google.com "Google's Homepage")
 with a title.
 Hover your mouse on top of it.

A reference link is marked by a second set of square brackets with a reference name inside. [Link to Example][refexample] is displayed as:

Link to Example

The reference marker has to be repeated somewhere else in the file, followed by a colon :, the URL and an optional title:

[refexample]: http://www.example.com "Example page"

This line is never shown, the information is only used to generate the the link.