You typed some text to make your first comment, and it looked something like this:

Elder Millennial here. All I know about markdown is:

1. To make a hard copy of a thought or conversation. "Mark that down in your notes, so we don't forget."

2. A discount or sale. "Did you see the 30% markdown on three legged jeans?"

The way your comment actually displays is different though, isn’t it? The numbered items are indented and come one after the other without any space inbetween, and the text within each numbered item is properly aligned.

What you entered is just text, and text by itself is inherently meaningless. “Markdown” is the name of a particular standard way of formatting text so that programs can reliably interpret parts of that text as representing the writers desire for their text to be displayed a particular way. You can kind of think of it like a programming language. As another basic example, consider this text:

This is a paragraph.
This        is still    the same
       paragraph.

Here is the second one.





And here is the third                   one.

I’m going to paste this text right after this sentence; notice how the amount of space doesn’t matter, and how a new paragraph is denoted by at least two line breaks.

This is a paragraph. This is still the same paragraph.

Here is the second one.

And here is the third one.

Markdown is a markup language, which can be used by users to indicate formatting hints to the underlying system. For example, you want a text to be bold, a markup language lets you tell that to the website in a way it understands.

Older markup languages tended to be verbose and complicated. For example, this is a numbered list in BBCode, which is the classic forum markup language: [ol][li]Item one[/li][li]Item two[/li][/ol].

Markdown keeps it simple and intuitive, for the most part.

1. item 1
2. item 2

The above is a numbered list in Markdown. Much simpler than the BBCode version. Simple enough that people like you can do it without even being aware of Markdown at all.

---

*This is cursive text*
**This is bold text**

# this is a heading

## this is a smaller heading

###### usually up to six levels are supported, but this might differ based on the implementation (my instance seems to make all of these the same size)

> this is a quote
it can span multiple lines too

this is a bullet point list:
- item 1
- item 2

[Links are more complicated, but still as easy as they can be](https://example.org)

The above doesn’t actually display formatted because I used a code block to show the Markdown as written. The below is how the above actually displays:

This is cursive text This is bold text

this is a heading

this is a smaller heading

usually up to six levels are supported, but this might differ based on the implementation (my instance seems to make all of these the same size)

this is a quote it can span multiple lines too

this is a bullet point list:

• item 1
• item 2

Links are more complicated, but still as easy as they can be

---

edit: this is what the original creator of Markdown has to say on the matter:

Markdown is intended to be as easy-to-read and easy-to-write as is feasible.

Readability, however, is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions. While Markdown’s syntax has been influenced by several existing text-to-HTML filters — including Setext, atx, Textile, reStructuredText, Grutatext, and EtText — the single biggest source of inspiration for Markdown’s syntax is the format of plain text email.

To this end, Markdown’s syntax is comprised entirely of punctuation characters, which punctuation characters have been carefully chosen so as to look like what they mean. E.g., asterisks around a word actually look like emphasis. Markdown lists look like, well, lists. Even blockquotes look like quoted passages of text, assuming you’ve ever used email.