Change deb dependencies to list Text::Markdown before markdown, since the former...
[ikiwiki.git] / 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]]