Links

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!

Accessibility: Link Titles

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 < >.

• <https://www.codecademy.com/resources/docs>
• <[email protected]>

The rendered output looks like this:

• https://www.codecademy.com/resources/docs
• [email protected]