web commit by http://adam.shand.net/

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

diff --git a/doc/bugs/undefined_tags_or_mismatched_tags_won__39__t_get_converted.mdwn b/doc/bugs/undefined_tags_or_mismatched_tags_won__39__t_get_converted.mdwn
index 1928d04f2c63c0511294b447d9b4ce827d23aebb..13ebe1cabda46e819f47ec2e2625b37722835678 100644 (file)
--- a/doc/bugs/undefined_tags_or_mismatched_tags_won__39__t_get_converted.mdwn
+++ b/doc/bugs/undefined_tags_or_mismatched_tags_won__39__t_get_converted.mdwn
@@ -1,34 +1,46 @@
-If you put in something such as undefined tags or mismatched tags in .mdwn file, ikiwiki will put <p></p> around them. But ikiwiki will NOT convert < and > to &amp;lt; and &amp;gt;! 
+If you put in something such as undefined tags or mismatched tags in .mdwn file, ikiwiki will put &lt;p>&lt;/p> around them. But ikiwiki will NOT convert < and > to &amp;lt; and &amp;gt;! 
 
-    <section>
+     <section>
 
-    some text
+     some text
 
-    </section>
+     </section>
 
 
 the output html
 
-   <p><section></p> <p>some text</p> <p></section></p> 
+    <p><section></p> <p>some text</p> <p></section></p> 
 
 And another example of mismatched tags:
 
 
 
-    <div>
+     <div>
 
-   some text
+     some text
 
-    </div>
-    </div>
+     </div>
+     </div>
 
 
-   The out put becomes:
+The out put is:
 
-   <div>
+    <div>
+
+    some text
+
+    </div>
 
-   some text
+    <p></div></p>
 
-   </div>
+> This is a bug in markdown. Actually, not converting `<` and `>` in tags is a
+> markdown feature -- markdown allows inserting arbirary html, even if it's
+> made-up tags. And putting paragraph tags around your `<section>` tag is
+> understandable, since markdown can't know if `<section>` is intended to
+> be a block-level tag or not. The bug is that it puts the `<p>` around the
+> trailing `<div>` -- it does know what a div is, and it should know that's
+> illegal and not do it. I've filed a [bug report](http://bugs.debian.org/459269) about that issue
+> alone. If you feel the other things you brought up are bugs, please talk
+> to the markdown maintainer. --[[Joey]]
 
-   <p></div></p>
+[[tag done]]