wiki: AboutMarkdown page shows incorrect inline link syntax

[pmocek-wiki-comment-deveiate-20051013@…]

On the BlueCloth wiki AboutMarkdown page, the sample Markdown source includes an inline link for which the title is inclosed in parenthesis (instead of single or double quotes as described at http://daringfireball.net/projects/markdown/syntax#link).

i.e., this:

  [1]: http://www.azureva.com/gb/italie/mags/grand-canal.php3 
       (Venice: The Grand Canal)

should be this:

  [1]: http://www.azureva.com/gb/italie/mags/grand-canal.php3 
       "Venice: The Grand Canal"

or this:

  [1]: http://www.azureva.com/gb/italie/mags/grand-canal.php3 
       'Venice: The Grand Canal'

[deveiant]

The syntax in the cited page is actually valid Markdown, though it isn't documented anywhere. You can verify this by pasting the source into the Markdown dingus tool.

That said, it is very confusing to have undocumented syntax in the example, and I thank you for bringing it to my attention. I'll fix it immediately.

[deveiant]

Fixed.

[pmocek-wiki-comment-deveiate-20051013@…]

Strangely, while the Markdown syntax documentation clearly states that only double quotes or single quotes are used to delimit titles of reference-style links, the Markdown Dingus recognizes double quotes and *parenthesis* -- but not single quotes -- for these titles. Ditto for Markdown command-line utility (version 1.0.1 running on Debian GNU/Linux). I have contacted the author and am awaiting a response.

[pmocek-wiki-comment-deveiate-20051013@…]

Markdown author John Gruber writes:

I think all three delimiters should be both supported and documented. That parens aren't mentioned in the docs is an oversight, and that single quotes don't actually work is a bug.

and

I've updated the docs to mention parens and the bug: http://daringfireball.net/projects/markdown/syntax#link

[deveiant]

Excellent. Thanks for taking the time to track this down and get the documentation fixed.