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