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.