I don’t know who needs to hear this but

1. Next time
1. You write
1. An ordered list
1. In markdown
1. Just use 1.

@rossta I know like every markdown rendering engine will take care of the numbering for the html rendered output, but it also kind of defeats the purpose of using markdown so that it’s readable in plain text too.

I guess maybe it’s good if you’re using markdown solely to make html generation easier and not because you want the input to be just as understandable.

@kjg Fair, but I don’t use Markdown because it’s easier to read but because it’s easier to edit and maintain that raw HTML.

Maintaining the correct order of numbers is objectively harder on the editor.

As for readability, does it matter the 6th item has a 6 next to it? Debatable. I can’t think of a time where I’ve cared about it. But I accept it matters to some.

I’m willing to bet there are plenty of markdown users who don’t know about "1 dot" and would be pleasantly surprised to hear.

@rossta I agree, it’s definitely cool to share the knowledge and sorry if this is taking the convo in an unwanted direction, it just happened to be the bit that peaked my interest.

If the numbering of each element isn’t important, would using an unordered list be more semantically appropriate?

Anyway, I totally agree that this is useful when the source is never intended to stand on its own. Renumbering a list when you insert something in the middle is a huge pain!

@kjg No angst here and none intended. Internet communication is hard! Healthy debate is welcome. I’m usually wrong anyways, especially when it’s with my wife.

When it comes to prose, I find ordered content tends to have more value to the reader than the writer. Steps in a recipe or "how to install this code from source" are good examples. Maybe a counter example is Dave Letterman’s Top Ten but I find that use case less common in my experience.