Markdown Link Generator

How to use the markdown link generator

1. Enter the link text and URL.
2. Add a title if you want a tooltip.
3. Copy the Markdown.

About this tool

Markdown link syntax is simple enough to write by hand, and that is exactly why the failures are so common. Two cases break a hand-written link silently.

A bracket in the link text ends the label early, so `[See [note] here](url)` produces something unintended. Brackets are escaped here.

A URL containing a space or a closing parenthesis breaks the target. Wikipedia URLs are the classic example — an address ending in `(disambiguation)` closes the link at the wrong parenthesis. Markdown allows the URL to be wrapped in angle brackets to solve this, which is done automatically when needed.

The optional title appears as a tooltip on hover. It is rarely used and worth knowing about, since it is the only way to attach extra explanation to a link without putting it in the visible text.

Common uses

• Linking to a URL containing brackets or spaces.
• Building links with text containing punctuation.
• Learning the syntax including the title attribute.

Frequently asked questions

Why does my link break on a URL with brackets?

The first closing parenthesis ends the link. Wrapping the URL in angle brackets fixes it, which happens automatically here.

What is the title for?

It becomes a tooltip on hover. It is optional and rarely used, but it is the only way to add explanation without changing the visible text.

Do I need to encode the URL?

Not usually. Angle brackets handle spaces and parentheses, which are the cases that actually break links.