markdown bug

[ikiwiki.git] / doc / bugs / iniline_breaks_toc_plugin.mdwn

diff --git a/doc/bugs/iniline_breaks_toc_plugin.mdwn b/doc/bugs/iniline_breaks_toc_plugin.mdwn
index 41174f987115a5fd5fec38c5ee21e66e2decd5fc..ab853208ca9a2843f30bc4c465f668528517d45e 100644 (file)
--- a/doc/bugs/iniline_breaks_toc_plugin.mdwn
+++ b/doc/bugs/iniline_breaks_toc_plugin.mdwn
@@ -1,6 +1,8 @@
 Hi, I try to make an example to reproduce some bug with inline and toc plugins.
-My friend uses 
-\[[inline pages="users/joey" raw="yes"]]
+My friend uses
+
+    \[[inline pages="users/joey" raw="yes"]]
+
 to include common snippets in various pages, and it works as advertised, but if toc plugin is used, page is messed up.
 
 I'll try here to reproduce one example...
@@ -9,6 +11,20 @@ You can see that wikilink is rendered in one line and 'here's paragraph' is not
 
 All this is displayed correctly if toc is removed.
 
+> Thanks for the clear explanation and example. This is a bug in markdown.
+> Version 1.0.1 gets confused by the toc div, which is followed by a few
+> lines of markdown, and then by a second div for the inlined page. It
+> doesn't convert the markdown in the middle to html.
+> 
+> I've tested with markdown 1.0.2 and it seems to render this ok. 1.0.2 has
+> a much improved parser, which is known to fix several block-related
+> problems, including this one. It is currently packaged in experimental in
+> Debian, and I suggest you give it a try if you're experiencing this
+> problem.
+> 
+> I'm going to close this bug report since it's a markdown bug. --[[Joey]]
+[[tag done]]
+
 
 TEST1
 =====