Markdown parsing of bulleted list does not support lazy continuation lines

[kescobo]

Often, one wants to add new lines in the plain text that are not rendered as new lines in html. Documenter seems to treat these differently than other markdown renderers. For example:

# Test Doc

- A bullet
    - Bullet indent
- Long bullet text **not**
    wrapped to new line
- Long bullet text
wrapped to new line

In the markdown formatters I'm familiar with, the 2nd and third bullets are rendered the same - the 4 spaces in the second bullet don't change anything. Eg, in Atom's markdown preview:

But julia treats them differently (noticed in Documenter):

MWE (thanks to @KristofferC - see here) :

julia> using Markdown

julia> md = Markdown.parse("""
       - Long bullet text
       wrapped to new line
       """);

julia> md.content
2-element Array{Any,1}:
 Markdown.List(Any[Any[Paragraph(Any["Long bullet text"])]], -1, false)
 Markdown.Paragraph(Any["wrapped to new line"])                        

julia> md
    •    Long bullet text

  wrapped to new line

[mortenpi]

I'll just add that what @kescobo proposes would get us closer to CommonMark too.

[cdsousa]

Adding a paragraph around each item is also a problem: https://discourse.julialang.org/t/parsing-markdown-lists-add-paragraph-to-items/36169

Julia Markdown parser:

• qwe

• rty

Other Markdown parsers:

• qwe
• rty

[nathanrboyer]

There should be a newline inserted after the final line of a block list. The last line of the previous bullet looks like it belongs to the next bullet.

Documenter.jl Showcase Documentation Render

Documenter.jl Showcase GitHub Render

[fingolfin]

The Markdown stdlib currently does not support lazy continuation lines. A shorter example that it doesn't handle right is

- foo
bar

Fixing this in the current code base is a bit tricky. Hmm.