Nested lists are too picky about whitespace

[chbrown]

Here's some Markdown markup:

Break.

* Root level
  * Second level
    * Third level
  * Back to second level

Break again.

1. Root level
  * Second level
    * Third level
  * Back to second level

Final break.

1. Root level
   * Second level
     * Third level
   * Back to second level

End of example.

This renders:

The middle list should look like the last list.

See this gist for the same input with proper output: https://gist.github.com/chbrown/be1fd39b26da6022846d01d7b2ccfaa4

[gettalong]

Thanks for showing this example!

There is actually a bug in kramdown concerning the parsing of the middle list:

1. Root level
  * Second level
    * Third level
  * Back to second level

1. The first line is parsed, indentation is set to three spaces because the R of Root level is in column three.
2. The part * Second level is indented two spaces. This means it is part of the first list item because of the "lazy list item content" rule. However, it should not start a nested list because the needed indentation is off (one less than needed). This is the bug.

So the output of the above should actually be:

 <ol>
  <li>Root level
  * Second level
    <ul>
      <li>Third level</li>
      <li>Back to second level</li>
    </ul>
  </li>
</ol>

The part * Third level starts a nested list because its indentation is four and that is more than the needed indentation of three spaces and less than the maximum of six allowed spaces (three for the needed indentation and three for the maximum allowed indentation of a list item marker).

[gettalong]

Just looked at this again but it seems I was mistaken since the latest kramdown version already produces the correct output according to the syntax spec. So there is nothing to do here.

[chbrown]

Oh, so, the latest kramdown version renders the middle list like the last one?

Or if not, can you point me to the syntax spec you mentioned?

[gettalong]

@chbrown It renders as I show in my comment - here is the spec: http://kramdown.gettalong.org/syntax.html#lists

[chbrown]

Okay. So, to clarify for anyone else who stumbles on this issue:

My desired solution — kramdown not being so nitpicky about indentation — is a no-fix.

Instead, the bug here is that, as of my original post, the version of kramdown that GitHub was using to render Markdown in gists (etc.) was trying to parse the middle-nested list as a list, but it shouldn't have, since it wasn't indented enough. Anything not indented 'enough' should, according to the spec @gettalong linked to, be interpreted literally.

I'm still not clear why the "Back to second level" item stays in the same list as the "Third level" item, but the parser has already diverged by that point from what I was intending with the three levels, so perhaps whatever it's trying to do there is outside the scope of needing rationalization.

[gettalong]

kramdown is not "nitpicky", it just tries to follow a sensible specification. Try using other Markdown parsers and you will get many different behaviours, with many edge cases and cases where you can't tell from the source code what the output will be.

As for Github gists: They use a different Markdown dialect, not kramdown, for gists, so yes, the behaviour will differ in many cases. There is no Markdown spec.

As for the problem at hand, I have to apologize since it seems that some experimental code came into play when I tested - so the problem still needs to be fixed for the next release. I'm sorry for mixup!

[chbrown]

Github gists: They use a different Markdown dialect, not kramdown

You're right; a lot (😱) has happened since Aug 31 and I forgot that the gist renderer had the flexibility I wanted — the problem was that GitHub pages' Jekyll config demands using kramdown, and I'm rather fond of GitHub pages and Markdown. (Jekyll not so much, but sometimes it's worth taking a bit of Ruby medicine to avoid having to keep rendered files in source control.)

There is no Markdown spec.

Which is why I can get away with arbitrary prescriptive judgments like 'nitpicky' 😉

[gettalong]

I have looked at the issue in more detail now and there was another problem with the behaviour of the "Back to second level" item. So kramdown will now output the following:

<ol>
  <li>Root level
  * Second level
    <ul>
      <li>Third level
      * Back to second level</li>
    </ul>
  </li>
</ol>

Note that the output will be different when using the GFM parser if the option "gfm_quirks" includes "paragraph_end" which is the default!