X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/0a09638f968f1b6c82b74ede4caa87461721e7d6..4f609f457dd99ece54c36e92acc94fa2e9db3498:/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn

diff --git a/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn b/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
index afeaff60e..4849edd63 100644
--- a/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
+++ b/doc/bugs/Toc_map_and_template_plugins_do_not_play_well_together.mdwn
@@ -8,7 +8,7 @@ The following renders incorrectly:
 
 	# header2
 
-	\[[map pages="sandbox"]]
+	\[[!map pages="sandbox"]]
 
 
 Removing the `\[[!toc]]` directive or moving it at the end of the page
@@ -16,3 +16,15 @@ makes the whole wiki page be rendered as expected.
 
 Hint : in all cases, the non-interpreted markdown code is copied as-is
 in the HTML output, without any leading `<p>` or any HTML formatting.
+
+> You're using the old version of `markdown`, that is known to have a broken block
+> html parser, that will get confused if markdown is present between two
+> separate html blocks, and not format the markdown.
+> 
+> This is fixed in [[!cpan Text::MarkDown]] 1.0.19. markdown 1.0.2 also
+> fixes the problem. Install either one. I'm going to make ikiwiki's
+> dependencies list Text::Markdown before markdown, since people keep
+> stumbling over this. (The downside is that the old broken markdown is
+> faster). --[[Joey]]
+
+[[done]]