The reason for using Markdown is simple: pandoc. Pandoc is just that damned good.
The reason for using Markdown is simple: pandoc. Pandoc is just that damned good.
[1] https://en.wikipedia.org/wiki/ReStructuredText
[2] The book can be downloaded for free: http://internetmeme.de
[3] About the writing process: https://news.ycombinator.com/item?id=12311546
I wouldn't say reST is all that similar looking to Markdown though: they have very different philosophies, and really only coincide on the fact that they're used for marking up plaintext documents.
None of this bothers me, and directives and roles the source of much of reST's extensibility and power, but apparently those are the things that make reST a bit intimidating compared to the likes of Markdown.
The problem with that is that the syntax is comparatively heavyweight. Part of this is due to reST's alignment rules and partly down to the generality of directives.
Let's take 'image' as an example. The simple way to embed an image in reST is this:
.. image:: foo.png
And in Markdown: 
And with some alt text: .. image:: foo.png
:alt: Foo!
And in Markdown: 
I've had people struggle with image directives simply because it doesn't sink in that the `:alt:` attribute has to be aligned with the directive name, whereas the rough equivalent in Markdown has no such issues.OTOH, once you know how to embed an image in reST, you're 90% of the way to knowing how to embed a code block, whereas in Markdown you need to learn a little bit more syntax. The downside of that is that this:
.. code::
print("Hello, world!")
Is more heavyweight than: ``
print("Hello, world!")
``
And people prefer the latter as it's less to type to the former, even if the former introduces no special-purpose syntax.This is where Markdown's ad hoc nature has benefits over reST's more structured nature: if you want to embed an image in Markdown, you learn how to embed an image; in reST, you learn the directive syntax so you can embed images. That gives Markdown and reST different learning curves. Markdown gives you lots of little easy-to-learn tools, but requires that you be constantly learning new tools as you go along, whereas reST gives you fewer, slightly more complex tools you have to learn up front, and all the new stuff you learn later is based off of those. Moreover, Markdown has less impact on the text due to its ad hoc markup being more compact, unlike reST, which takes the route of being more general at the cost of being more verbose.
Somebody starting out confronted with either reST or Markdown will look at both and see that the latter looks more like plain text than the former, and thus there is less of an initial barrier to entry. That's why the likes of MkDocs exist in spite of the likes of Sphinx existing long before MkDocs and its ilk did.
TL;DR: Markdown makes easy stuff super easy and hard stuff possible; reST makes the easy stuff a little harder than Markdown, but lets you lift mountains.
Edit: s/codeblock/code/
http://pandoc.org (scroll down past the text).
Personally, I like that Markdown gives me so little control over formatting. It forces me to focus on the text instead, which is why I moved away from LaTeX. Formatting is something I'd rather do after the writing is done. If you're using LaTeX or HTML, you can embed formatting directly, and if you're using another intermediate format, Pandoc gives you a lot of control over how it's generated.
I looked for the origins (not popularity, but a lower bound):
Markdown 1.0.1 (18 KB) — 17 Dec 2004
source: http://daringfireball.net/projects/markdown/
Github - October 2007 - First commit
source: https://github.com/about
By the time Github launched, Markdown had eaten most of the lightweight markup language for lunch. If you want to compare its popularity, you first have to look at the relative popularity of the other lightweight text markup formats: https://en.wikipedia.org/wiki/Lightweight_markup_language
Also, you have to keep in mind the amount of cachet Schwartz and Gruber had at the time, which helped no end in popularising it. Popular blogging platforms at the time of its release, such as Bloxsom and Moveable Type quickly got support for Markdown.
Arguably, if you wanted to choose a site that's done a lot of popularise Markdown, Reddit, which launched in 2005, would be a much better example.
I choose markdown primarily because it's readable.