Looking for any studies OR anecdotal stories on the usability of lightweight markup languages (like Markdown, MediaWiki or BBCode) [duplicate]

1. Is a lightweight markup language?
2. Which lightweight markup language is used for the GitHub readme files?
3. Why you shouldn t use Markdown for documentation?
4. Is a lightweight markup language that you can use to add formatting elements to plaintext text documents?

Is a lightweight markup language?

A lightweight markup language (LML), also termed a simple or humane markup language, is a markup language with simple, unobtrusive syntax. It is designed to be easy to write using any generic text editor and easy to read in its raw form.

Which lightweight markup language is used for the GitHub readme files?

Markdown is a lightweight markup language, mostly used for writing readmes, but also for writing blogs and books.

Why you shouldn t use Markdown for documentation?

Markdown doesn't have an extension system that would allow you to extend the language without affecting the way it is parsed. Lock-In and Lack of Portability. The tons of flavors and the lack of semantic support results in a lock-in. The more documentation you have, the more you are tied to the existing configuration.

Is a lightweight markup language that you can use to add formatting elements to plaintext text documents?

Markdown is a lightweight markup language that can be used to add formatting elements to plaintext documents. It is very popular, especially among developers, and is widely used by our own teams and in Nfield documentation.