doc/ikiwiki/wikilink/discussion.mdwn



Creating an anchor in Markdown
Is it a native Markdown "tag" for creating an anchor? Unfortunately,
I haven't any information about it at
Markdown syntax page.
Of course, I know that I can use HTML tag to do it,
for example <a name="foo" />, but I don't want to mix Markdown
and HTML code if it's not necessary.
BTW, ikiwiki doesn't displays the #foo anchor in the example
("To link to an anchor inside a page...") at [[WikiLink]] page...
--[[Paweł|ptecza]]

No such syntax exists in markdown.  ikiwiki could certainly have a
[[preprocessor_directive|preprocessordirective]] for it, though.
--[[JoshTriplett]]


[[tag wishlist]]
I'd like to implement such a thing.  Joey, what is this supposed to look like?
\[[anchor WHATEVER]]?  --[[tschwinge]]


Why would you want to use a preprocessor directive for something that can
be more shortly and clearly done with plain HTML? Markdown is designed
to be intermixed with HTML. --[[Joey]]


I tend to disagree.
It just doesn't feel right for me to put HTML code straight into Markdown files.
Quoting http://daringfireball.net/projects/markdown/:

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.

Also, in theorie at least, Markdown might also support other output formats than HTML.
Those wouldn't know about how to deal with the intermingled HTML code.
--[[tschwinge]]


The lack of the #foo anchor in the anchor example on [[wikilink]]
definitely looks like a bug.  --[[JoshTriplett]]


Fixed that --[[Joey]]


Considering a hierarchy like foo/bar/bar, I had the need to link from the
foo/bar/bar page to the foo/bar one.  It would have been convenient to
simply write [[wikilink]]s like \[[../bar]] (or even just \[[..]]?), but
this doesn't work, so I had to resort to using \[[foo/bar]] instead.
--[[tschwinge]]