Nested bullets aren't rendering correctly about markdown

[sethladd]

cc @keertip

[srawlins]

😦 legit.

[srawlins]

OK @sethladd, I investigated this a bit; we're using the 4-space rule, and a strictness in lists, so:

* one
  *  nested

will NOT nest. You need 4 spaces before the nested *. Also:

* one
    * nested

will NOT nest. You need a blank line before lists:

* one

    * two

should nest. The example in @munificent 's Effective Dart: Documentation correctly shows how to nest lists.

[srawlins]

One might also consider this a dup of #14

[sethladd]

Should we match GitHub here? Github's MD seems to be a defacto standard.

Also, thanks for taking a look!

[kwalrath]

In my markdown experience, I expect (through painful experience) to need a blank line above the first bullet, but none in the rest of the list.

Requiring blank lines within lists feels broken.

[sethladd]

Requiring blank lines within lists feels broken.

Agreed.

[munificent]

Should we match GitHub here? Github's MD seems to be a defacto standard.

I think we should generally aim to match CommonMark but if there are places where that diverges from GitHub, we'll want to think long and hard about which side to lean towards.

Requiring blank lines within lists feels broken.

Here, it's only needed to start the nested list, but, yes, I agree. Markdown is actually really weird here. The presence of newlines affects the resulting output. If you have:

* A

* B

* C

Then you get an unordered list where each item is a paragraph. If you do:

* A
* B
* C

Then you get bare list items containing just the text with no <p>. There is no way in Markdown to have a list with a single item whose body is a single paragraph. 😕

[srawlins]

#76 actually fixed this.