About Markdown Links

Markdown supports several link formats, each with different use cases and benefits.

Link Types

1. Inline Links

The most common format. The URL appears directly in the text.

[Link text](https://example.com "Optional title")

Use when: Links are used once or URLs are short

2. Reference Links

Separate link text from URL definition, improving readability.

[Link text][1]

[1]: https://example.com "Optional title"

Use when: Same URL is referenced multiple times

3. Reference Links (Named)

Use descriptive IDs instead of numbers.

[Link text][my-reference]

[my-reference]: https://example.com "Optional title"

Use when: You want meaningful reference names

4. Autolinks

Automatically creates clickable links from URLs.

<https://example.com>

Use when: You want the URL itself to be the link text

Best Practices

• Descriptive text: Use meaningful link text, not "click here"
• Title attributes: Add context with hover text
• Reference style: Use for multiple references to same URL
• URL encoding: Escape spaces and special characters in URLs
• Relative links: Use for internal documentation links

Link Text Guidelines

• Make link text descriptive and meaningful
• Avoid generic phrases like "click here" or "read more"
• Keep link text concise (2-5 words typically)
• Use sentence case, not all caps

URL Formatting

• Absolute URLs: https://example.com/page
• Relative URLs: ./other-page.md or ../parent/page.md
• Anchor links: #section-heading
• Email links: mailto:user@example.com

Special Cases

*[emphasized link](https://example.com)*
**[bold link](https://example.com)**


- [First link](https://example.com)
- [Second link](https://example2.com)


Image as link: [![Alt text](image.jpg)](https://example.com)