Merge branch 'master' of ssh://git.ikiwiki.info
[ikiwiki] / doc / bugs / external_links_inside_headings_don__39__t_work.mdwn
1 The standalone 'markdown' utility is perfectly happy with an external link inside a `<h1>`, e.g.:
2
3     # Review of [Dwarf Fortress][]
4     ...
5     [Dwarf Fortress]: http://www.bay12games.com/dwarves/
6
7 produces
8
9     <h1>Review of <a href="http://www.bay12games.com/dwarves/">Dwarf Fortress</a></h1>
10
11 but when I try to use this construct in an ikiwiki page, I get 
12
13     <h1>Review of [Dwarf Fortress][]</h1>
14
15 It works fine with h2 and deeper.  The square brackets also appear in the output of an [[ikiwiki/directive/inline]] directive in archive mode, I haven't tried non-archive mode.
16
17 > I think you were confused by markdown's slightly wacky mix of square brackets and parens.
18 > The url in a markdown link goes in parens, not square brackets. For example:
19
20 # [Google](http://google.com/)
21
22 > [[done]] --[[Joey]]
23
24 >> It works here but it definitely does *not* work on my wiki; but on further experimentation, I believe my problem is being caused by JasonBlevins' [h1title](http://jblevins.org/git/ikiwiki/plugins.git/plain/h1title.pm) plugin.