The list syntax is severly lacking a flexible way to include HTML valid tags inside the final rendered output.
For example:
* num1
* num2
paragraph inside num2
* num3
The above should render as:
<ul>
<li>num1</li>
<li>num2 <p>paragraph inside num2</p> </li>
</ul>
While now it renders something like:
<ul>
<li>num1</li>
</ul>
<p>paragraph inside num2</p>
<ul>
<li>num2 </li>
</ul>
A possible solution would be to include an optional end-of-list-item syntax.
For example:
* num1
* num2
paragraph in num2 /*
* num3
The '/*' is just an invention, choose any logical pair in ' <some_syntax_character>[-|*]'.
Just for reference:
http://stackoverflow.com/questions/4967976/what-are-the-allowed-tags-inside-a-li