multimarkdown user’s guide
This allows you to use
to refer to this
section speciﬁcally, and not another section named
works with atx- or settext-style headers.
If you have already deﬁned an anchor using the same id that is
used by a header, then the deﬁned anchor takes precedence.
In addition to headers within the document, you can provide la-
bels for images and tables which can then be used for cross-references
Link and Image Attributes
Adding attributes to links and images has been requested for a long
time on the Markdown discussion list. I was fairly opposed to this, as
most of the proposals really disrupted the readability of the syntax.
Iconsider myself a “Markdown purist”, meaning that I took John’s
introduction to heart:
The overriding design goal for Markdown’s formatting syntax is
to make it as readable as possible. The idea is that a Markdown-
formatted document should be publishable as-is, as plain text, without
looking like it’s been marked up with tags or formatting instructions.
While Markdown’s syntax has been inﬂuenced by several existing
text-to-HTMLﬁlters, the single biggest source of inspiration for Mark-
down’s syntax is the format of plain text email.
Because there was not a syntax proposal that I felt ﬁt this goal, I
was generally opposed to the idea.
Then, Choan C. Gálvez proposed
abrilliantly simple syntax that
stayed out of the way. By simply appending the attributes to the link
reference information, which is already removed from the text itself,
it doesn’t disturb the readability.
This is a formatted ![image] and a [link] with attributes.
[image]: http://path.to/image "Image title" width=40px height=400px
http://path.to/link.html "Some Link" class=external
style="border: solid black 1px;"
This will generate width and height attributes for the image, and
aborder around the link. And while it can be argued that it does
look “like it’s been marked up with tags [and] formatting instruc-
tions”, even I can’t argue too strongly against it. The link and the
title in quotes already look like some form of markup, and the the
additional tags are hardly that intrusive, and they offer a great deal