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.
A URL (Uniform Resource Locator) starting with
https:// is automatically transformed into a link by the linkify extension. If you want to stop this default behavior, you can set
false in the configuration.
There are two ways to include links from a word or phrase:
- You can include them inline within the text.
- They may also be written in a separate reference like a footnote.
We can surround URLs for better legibility in the markdown file
with angle brackets
<>. The result is the same:
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
- [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.
- This is an inline-style link
- This is an inline-style link 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:
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.