Incorrect indent in 10 minute tutorial

Meta
1

Here in the nestedLists tut: Markdown Tutorial - Nested Lists
The first page says:

To nest one list within another, indent each item in the sublist by four spaces.

But in the exercise the nested list are not all indented by 4 spaces.

And the first page also says:

You can also nest other elements like paragraphs, blockquotes or code blocks.

But it did not mention how many spaces should used when nesting paragraphs, blockquotes or code blocks.

As a user will think they all indent with 4 spaces. Is that correct?

If yes, the exercise for this did not use 4 spaces.
If no, we should add how many spaces should used in case of paragraphs, blockquotes or code blocks.

2 Likes
2

I believe that predates the commonmark spec being fully formalized, but it’s also the “most compatible” rule.

- item 1
  - item 2

Looks like only two spaces is enough in commonmark.

1 Like
3

Here’s the relevant part of the spec:

The most important thing to notice is that the position of the text after the list marker determines how much indentation is needed in subsequent blocks in the list item. If the list marker takes up two spaces, and there are three spaces between the list marker and the next non-whitespace character, then blocks must be indented five spaces in order to fall under the list item.

Here’s a link to the tutorial source is anyone has the time to clarify. I was going to take a quick stab but it looks a bit more involved than just updating the text.

1 Like