Skip to content
All Markdown syntax

Links in Markdown

Links and images

Markdown syntax

Works everywhere
[link text](https://yamuno.com)

Inline link. The most common form.

Put the link text in square brackets and the URL straight after it in parentheses, with no space between them. For long or repeated URLs, reference-style links keep the paragraph readable.

All ways to write it

  • [link text](https://yamuno.com)
    Inline link. The most common form.Works everywhere
  • [link text](https://yamuno.com "Title")
    With a tooltip title.Works everywhere
  • <https://yamuno.com>
    Autolink: the URL itself becomes the link.Works everywhere
  • https://yamuno.com
    A bare URL is linked automatically on GitHub.GitHub Flavored Markdown
  • [link text][docs]
    
    [docs]: https://yamuno.com/docs
    Reference style keeps long URLs out of the paragraph.Works everywhere

Example

You type

Read the [import guide](https://yamuno.com/docs/markdown-importer-for-confluence) first.

Questions go to <mailto:[email protected]>.

You get

Read the import guide first.

Questions go to mailto:[email protected].

Questions

Why isn't my link working?

A space between ] and ( breaks it: [text] (url) is plain text. Spaces inside the URL also break it; write them as %20 or wrap the URL in < >.

How do I open a link in a new tab?

Markdown has no syntax for it. Use HTML where allowed: <a href="https://yamuno.com" target="_blank">text</a>. GitHub ignores target.

How do I link to another Markdown file?

Use a relative path: [Setup](./setup.md). GitHub and most static site tools resolve it.

Link in Confluence

Links render in a Markdown Macro+ macro. On export, Markdown Exporter keeps external links as they are and rewrites links between Confluence pages as relative .md paths, or as [[wikilinks]] in Obsidian mode.

Related syntax

Also in Links and images

See all Markdown syntax