> Once you start using markdown flavors, which is required for any non-trivial documentation, you lose all portability benefits. This is the same argument peop

> Once you start using markdown flavors, which is required for any non-trivial documentation, you lose all portability benefits. This is the same argument people use for ORMs over bare SQL - "what if we change database later, we'll have to do lots of rewriting of queries!!" Except people almost never change databases. I shouldn't think people change their documentation formats either.