Links

Published Aug 6, 2021Updated Aug 22, 2023
Contribute to Docs

In Markdown, a link is created by enclosing the link text in square brackets, [Link text], and then following it immediately with the URL in parentheses, (https://website-name.com).

[Link text](https://website-name.com)

For example:

We just updated our [Docs Contribution Guide](https://www.codecademy.com/pages/contribute-docs)!

The output would look like:

We just updated our Docs Contribution Guide!

A title for a link can be optionally added. This will appear as a tooltip when the user hovers over the link. To add a title, enclose it in parentheses () after the URL.

Links should have link titles so that screenreaders can narrate them as well as a user can Tab through the page.

[Link text](https://website-name.com 'Link title')

For example:

My favorite Craigslist category is [Missed Connections](https://newyork.craigslist.org/d/missed-connections/search/mis 'The best place on the internet').

The output would look like:

My favorite Craigslist category is Missed Connections.

URLs and Email Addresses

To quickly turn a URL or email address into a link, enclose it in angle brackets < >.

The rendered output looks like this:

All contributors

Looking to contribute?

Learn Markdown on Codecademy