Syntax guide

Markdown Link

Markdown links use a readable pattern: put the visible text in brackets and the destination in parentheses.

Quick answer

A Markdown link looks like `[label](https://example.com)`. The label is what readers see; the URL is where the link goes.

Reference

markdown link

Common link formats

Most documents only need a few link patterns.

  • Use `[text](URL)` for a normal link.
  • Use `![alt text](image-url)` for an image.
  • Use `[Email us](mailto:[email protected])` for email links.

Readable link text

Good link text tells readers what will happen before they click.

  • Write descriptive labels instead of `click here`.
  • Use reference links to keep long documents tidy.
  • Preview links before exporting HTML, PDF, or Word.

Examples

Copy-ready examples

Inline link
[Open MarkdownABC](/)

The text in brackets becomes the clickable label.

Reference link
Read the [Markdown guide][guide].

[guide]: /markdown-cheat-sheet

Reference links keep long URLs out of the main paragraph.

FAQ

Common questions

How do I write a Markdown link?

Use `[link text](URL)`. The bracket text appears in the document, and the URL in parentheses is the destination.

How do I add an image in Markdown?

Use `![alt text](image-url)`. It is the same basic shape as a link, with an exclamation mark at the front.

Can Markdown links open in a new tab?

Standard Markdown does not include a new-tab setting. Some platforms support extensions, but HTML is usually needed for that behavior.