Awkee / pandoc

Automatically exported from code.google.com/p/pandoc
GNU General Public License v2.0
0 stars 0 forks source link

Documentation: Block quotes within bullet points deviate from most Markdown implementations #283

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
What steps will reproduce the problem?

run pandoc on the following:

* this is a bullet point

  > This is a block quote within the bullet point

What is the expected output? What do you see instead?

Most implementations (Markdown.pl, PHP, MultiMarkdown) will convert the above 
as:

<ul>
<li><p>this is a bullet point</p>

<blockquote>
  <p>This is a block quote within the bullet point</p>
</blockquote></li>
</ul>

pandoc converts it as (tidied):

<ul>
  <li>this is a bullet point</li>
</ul>

<blockquote>
  <p>This is a block quote within the bullet point</p>
</blockquote>

It will convert it correctly if the blockquote is given four or more spaces.

Not all of the implementations show on Babelmark produce the block quote within 
the bullet, but it seems that most of the mainstream ones do. If this is an 
intentional difference in pandoc, it should probably be noted on the website.

What version of the product are you using? On what operating system?

pandoc 1.8, ghc 6.12.3

Original issue reported on code.google.com by jesse.k....@gmail.com on 3 Feb 2011 at 2:38

GoogleCodeExporter commented 9 years ago
Extra blocks inside a list item must be indented by four spaces.  The official 
markdown syntax description is pretty explicit about this (at least for 
paragraphs), but the implementation does not conform to the description.  I've 
chosen to conform to the description in pandoc.  This has come up a number of 
times on pandoc-discuss and markdown-discuss; you can search for "four space 
rule" if you're interested.

Original comment by fiddloso...@gmail.com on 3 Feb 2011 at 3:49

GoogleCodeExporter commented 9 years ago
I'm reclassifying this as a documentation bug.  I should be clearer about this 
divergence from the Markdown.pl implementation in the syntax documentation.

Original comment by fiddloso...@gmail.com on 3 Feb 2011 at 4:07

GoogleCodeExporter commented 9 years ago
Cool -- thank you for the reply.

Original comment by jesse.k....@gmail.com on 3 Feb 2011 at 4:07

GoogleCodeExporter commented 9 years ago
After reading through some of the discussions on similar topics on this and 
other lists, I wonder if a section headed "Four-space Rule" in the pandoc 
markdown section might head off some confusion. It's discussed throughout in 
individual cases, but is easy to miss as a general principle if you're coming 
from other implementations.

Apologies for the rush of questions as I immerse myself in this fantastic 
program.

Original comment by jesse.k....@gmail.com on 3 Feb 2011 at 4:54

GoogleCodeExporter commented 9 years ago
Fixed, 798c5d55bbfff566a7de9713ec38f1db75c96970

Original comment by fiddloso...@gmail.com on 5 Feb 2011 at 3:11