doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn

   1 The following renders incorrectly:
   2
   3         \[[!toc ]]
   4
   5         # header1
   6
   7         content1
   8
   9         # header2
  10
  11         \[[!map pages="sandbox"]]
  12
  13
  14 Removing the `\[[!toc]]` directive or moving it at the end of the page
  15 makes the whole wiki page be rendered as expected.
  16
  17 Hint : in all cases, the non-interpreted markdown code is copied as-is
  18 in the HTML output, without any leading `<p>` or any HTML formatting.
  19
  20 > You're using the old version of `markdown`, that is known to have a broken block
  21 > html parser, that will get confused if markdown is present between two
  22 > separate html blocks, and not format the markdown.
  23 >
  24 > This is fixed in [[!cpan Text::MarkDown]] 1.0.19. markdown 1.0.2 also
  25 > fixes the problem. Install either one. I'm going to make ikiwiki's
  26 > dependencies list Text::Markdown before markdown, since people keep
  27 > stumbling over this. (The downside is that the old broken markdown is
  28 > faster). --[[Joey]]
  29
  30 [[done]]