closing, user error
[ikiwiki.git] / 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]]