# Autolinks
Autolink (opens new window)s are absolute URIs and email addresses inside <
and >
. They are parsed as links, with the URL or email address as the link label.
A URI autolink (opens new window) consists of <
, followed by an absolute URI (opens new window) followed by >
. It is parsed as a link to the URI, with the URI as the link’s label.
An absolute URI (opens new window), for these purposes, consists of a scheme (opens new window) followed by a colon (:
) followed by zero or more characters other than ASCII whitespace (opens new window) and control characters, <
, and >
. If the URI includes these characters, they must be percent-encoded (e.g. %20
for a space).
For purposes of this spec, a scheme (opens new window) is any sequence of 2–32 characters beginning with an ASCII letter and followed by any combination of ASCII letters, digits, or the symbols plus (”+”), period (”.”), or hyphen (”-”).
Here are some valid autolinks:
Example 602
Markdown | HTML | Demo |
---|---|---|
|
|
Example 603
Markdown | HTML | Demo |
---|---|---|
|
|
Example 604
Markdown | HTML | Demo |
---|---|---|
|
|
Uppercase is also fine:
Example 605
Markdown | HTML | Demo |
---|---|---|
|
|
Note that many strings that count as absolute URIs (opens new window) for purposes of this spec are not valid URIs, because their schemes are not registered or because of other problems with their syntax:
Example 606
Markdown | HTML | Demo |
---|---|---|
|
|
Example 607
Markdown | HTML | Demo |
---|---|---|
|
|
Example 608
Markdown | HTML | Demo |
---|---|---|
|
|
Example 609
Markdown | HTML | Demo |
---|---|---|
|
|
Spaces are not allowed in autolinks:
Example 610
Markdown | HTML | Demo |
---|---|---|
|
|
Backslash-escapes do not work inside autolinks:
Example 611
Markdown | HTML | Demo |
---|---|---|
|
|
An email autolink (opens new window) consists of <
, followed by an email address (opens new window), followed by >
. The link’s label is the email address, and the URL is mailto:
followed by the email address.
An email address (opens new window), for these purposes, is anything that matches the non-normative regex from the HTML5 spec (opens new window):
/^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?
(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/
Examples of email autolinks:
Example 612
Markdown | HTML | Demo |
---|---|---|
|
|
Example 613
Markdown | HTML | Demo |
---|---|---|
|
|
Backslash-escapes do not work inside email autolinks:
Example 614
Markdown | HTML | Demo |
---|---|---|
|
|
These are not autolinks:
Example 615
Markdown | HTML | Demo |
---|---|---|
|
|
Example 616
Markdown | HTML | Demo |
---|---|---|
|
|
Example 617
Markdown | HTML | Demo |
---|---|---|
|
|
Example 618
Markdown | HTML | Demo |
---|---|---|
|
|
Example 619
Markdown | HTML | Demo |
---|---|---|
|
|
Example 620
Markdown | HTML | Demo |
---|---|---|
|
|