lesson.md

I hate markdown

1. Here is a list. I can do numbered lists.

2. I can do a list entry followed by two spaces.

   This means this is in the same paragraph

3. If I want a code block (with syntax highlighting, inside a list, something breaks:

   print("This needs a blank line before the code block")

4. And we're back to square one.

Markdown does support code inside of lists (indent by 8 spaces, not four), but you can't get syntax highlighting.

That is a feature of Github flavored markdown(GFM).
So you might want to check if a library understands GFM before starting any projects, if that is what you are planning to do.