[link](/my uri)
+ ```````````````````````````````` +Except if enclosed in pointy brackets: ```````````````````````````````` example -[link]() +[link]() . -[link](</my uri>)
+ ```````````````````````````````` +There can be a line break before or after an info string: ```````````````````````````````` example [link](foo bar) . -[link](foo -bar)
+ ```````````````````````````````` +```````````````````````````````` example +[link](foo bar +) +. + +```````````````````````````````` + +But no empty line: + +```````````````````````````````` example +[link](foo + +bar) +. +[link](foo
+bar)
+```````````````````````````````` + +There can also be no line break inside the target with angular brackets: ```````````````````````````````` example [link]([link] (/uri)
+[link] (/url)
```````````````````````````````` -The link text may contain balanced brackets, but not unbalanced ones, -unless they are escaped: +The link text may contain balanced brackets: ```````````````````````````````` example -[link [foo [bar]]](/uri) +[link [foo [bar]]](/url) . - + ```````````````````````````````` +But not unbalanced ones: ```````````````````````````````` example -[link] bar](/uri) +[link] bar](/url) . -[link] bar](/uri)
+[link] bar](/url)
```````````````````````````````` - ```````````````````````````````` example -[link [bar](/uri) +[link [bar](/url) . -[link bar
+[link bar
```````````````````````````````` +Unless they are escaped: + ```````````````````````````````` example -[link \[bar](/uri) +[link \[bar](/url) . - + ```````````````````````````````` The link text may contain inline content: ```````````````````````````````` example -[link *foo **bar** `#`*](/uri) +[link *foo **bar** `#`*](/url) . - + ```````````````````````````````` ```````````````````````````````` example -[](/uri) +[](/url) . -
[foo bar](/url)
+```````````````````````````````` + + +```````````````````````````````` example +[foo *[bar [baz](/url)](/url)*](/url) . -[foo bar](/uri)
+[foo [bar baz](/url)](/url)
```````````````````````````````` ```````````````````````````````` example -[foo *[bar [baz](/uri)](/uri)*](/uri) +](url2)](url3) . -[foo [bar baz](/uri)](/uri)
+*foo*
+*foo*
```````````````````````````````` @@ -7594,9 +7667,9 @@ and autolinks over link grouping: ```````````````````````````````` example -[foo`](/uri)` +[foo`](/url)` . -[foo](/uri)
[foo](/url)
*foo*
+*foo*
```````````````````````````````` ```````````````````````````````` example [foo *bar][ref] -[ref]: /uri +[ref]: /url . - + ```````````````````````````````` @@ -7741,7 +7813,7 @@ and autolinks over link grouping: ```````````````````````````````` example [foo[foo
[foo][ref]
[foohttp://example.com/?search=][ref]
```````````````````````````````` @@ -7834,13 +7906,16 @@ link text and the link label, then in the following we will have a single reference link, not two shortcut reference links, as intended: -``` markdown +```````````````````````````````` example [foo] [bar] [foo]: /url1 [bar]: /url2 -``` +. + +```````````````````````````````` (Note that [shortcut reference links] were introduced by Gruber himself in a beta version of `Markdown.pl`, but never included @@ -7883,20 +7958,20 @@ backslash-escaped: ```````````````````````````````` example [foo][ref[] -[ref[]: /uri +[ref[]: /url .[foo][ref[]
-[ref[]: /uri
+[ref[]: /url
```````````````````````````````` ```````````````````````````````` example [foo][ref[bar]] -[ref[bar]]: /uri +[ref[bar]]: /url .[foo][ref[bar]]
-[ref[bar]]: /uri
+[ref[bar]]: /url
```````````````````````````````` @@ -7913,20 +7988,20 @@ backslash-escaped: ```````````````````````````````` example [foo][ref\[] -[ref\[]: /uri +[ref\[]: /url . - + ```````````````````````````````` Note that in this example `]` is not backslash-escaped: ```````````````````````````````` example -[bar\\]: /uri +[bar\\]: /url [bar\\] . - + ```````````````````````````````` @@ -7935,10 +8010,10 @@ A [link label] must contain at least one [non-whitespace character]: ```````````````````````````````` example [] -[]: /uri +[]: /url .[]
-[]: /uri
+[]: /url
```````````````````````````````` @@ -7947,12 +8022,12 @@ A [link label] must contain at least one [non-whitespace character]: ] [ - ]: /uri + ]: /url .[ ]
[ -]: /uri
+]: /url ```````````````````````````````` @@ -7961,7 +8036,7 @@ consists of a [link label] that [matches] a [link reference definition] elsewhere in the document, followed by the string `[]`. The contents of the first link label are parsed as inlines, -which are used as the link's text. The link's URI and title are +which are used as the link's text. The link's destination and title are provided by the matching reference link definition. Thus, `[foo][]` is equivalent to `[foo][foo]`. @@ -7994,9 +8069,9 @@ The link labels are case-insensitive: ```````````````````````````````` - As with full reference links, [whitespace] is not -allowed between the two sets of brackets: +allowed between the two sets of brackets, +so the first pair is treated as a [shortcut reference link]: ```````````````````````````````` example [foo] @@ -8014,9 +8089,9 @@ consists of a [link label] that [matches] a [link reference definition] elsewhere in the document and is not followed by `[]` or a link label. The contents of the first link label are parsed as inlines, -which are used as the link's text. The link's URI and title +which are used as the link's text. The link's destination and title are provided by the matching link reference definition. -Thus, `[foo]` is equivalent to `[foo][]`. +Thus, `[foo]` is equivalent to `[foo][]` and `[foo][foo]`. ```````````````````````````````` example [foo] @@ -8130,13 +8205,6 @@ Inline links also take precedence: ```````````````````````````````` -```````````````````````````````` example -[foo](not a link) - -[foo]: /url1 -. -foo(not a link)
-```````````````````````````````` In the following case `[bar][baz]` is parsed as a reference, `[foo]` as normal text: @@ -8163,8 +8231,9 @@ Here, though, `[foo][bar]` is parsed as a reference, since ```````````````````````````````` -Here `[foo]` is not parsed as a shortcut reference, because it -is followed by a link label (even though `[bar]` is not defined): +Here, `[foo]` is not parsed as a shortcut reference, because it +is followed by a link label (even though `[bar]` is not defined +and is then found to be a link text instead): ```````````````````````````````` example [foo][bar][baz] @@ -8221,11 +8290,14 @@ this is standardly used as the image's `alt` attribute. Though this spec is concerned with parsing, not rendering, it is recommended that in rendering to HTML, only the plain string content -of the [image description] be used. Note that in +of the [image description] be used. +Note that in the above example, the alt attribute's value is `foo bar`, not `foo [bar](/url)` or `foo bar`. Only the plain string content is rendered, without formatting. +The rules for inline formatting other than links is the same as for links: + ```````````````````````````````` example ![foo *bar*][] @@ -8244,6 +8316,8 @@ content is rendered, without formatting. ```````````````````````````````` +Inline image: + ```````````````````````````````` example  . @@ -8406,7 +8480,7 @@ If you want a link after a literal `!`, backslash-escape the ## Autolinks -[Autolink](@)s are absolute URIs and email addresses inside +[Autolink](@)s are absolute URLs and email addresses inside `<` and `>`. They are parsed as links, with the URL or email address as the link label. @@ -8491,7 +8565,7 @@ with their syntax: ```````````````````````````````` -Spaces are not allowed in autolinks: +Spaces are not allowed in autolink URLs. ```````````````````````````````` example