When comparing Markdown vs reStructuredText, the Slant community recommends Markdown for most people. In the question“What are the best markup languages?” Markdown is ranked 2nd while reStructuredText is ranked 5th. The most important reason people chose Markdown is:
Designed to be easy for a human to enter with a simple text editor, and easy to read in its raw form.
Specs
Ranked in these QuestionsQuestion Ranking
Pros
Pro Human-readable
Designed to be easy for a human to enter with a simple text editor, and easy to read in its raw form.
Pro Widely used
Markdown is quickly becoming the writing standard for academics, scientists, writers, and many more. Websites like GitHub and reddit use Markdown to style their comments.
Pro De facto standard
Markdown is ubiquitous. It's supported by nearly everything. The markup available in the common subset of all the many dialects isn't that rich, but it's usually enough to get the job done.
Pro Multi-directional
You can convert HTML to Markdown or Markdown to HTML. You can use tools like pandoc to convert to other formats as well.
Pro Revision friendly
It is easy to track changes for markdown documents as compared to other formats like doc, html, etc. You only need to place your markdown documents under some version control system.
Pro Human-readable
reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system.
Pro Technical documentation
Without any adjustments RST has many facilities for writing technical documentation (API docs, syntax highlighting code, embed code from source files).
Pro Parsing from Python
Python's docutils include a parser for RestructuredText.
Pro Extensible
Generators such as Sphinx allow you to define your own custom roles, directives and output generators.
Pro It's standardized
There's only one standard to adhere to - no "flavors".
Pro Large collections of themes available
Cons
Con Lacks a coherent standard
Lacks a coherent standard, just many semi-compatible dialects (MultiMarkdown, etc). This inconsistency can cause problems if the person writing the Markdown is using a different dialect from the one that will be used to render it.
Con Bad support for table
It has poor support for table, while table is an important part of article.
Con Bad support for larger documents
Works good for single file documents like READMEs.
Lack support for cross-references, TOCs, document index etc.
Con It doesn't support semantic markup
It's unstructured.
Con Setup can be tedious
If you prefer Python to stay out of the way so that you can focus on the task you are doing, you will find that overall Python just asserts itself far to much.