Don't write documentation in Markdown
This is missing the point.<p>The goal is "please write your documentation." What solution has the least friction around that for engineers? Right now, it's overwhelmingly Markdown.<p>It's not perfect, and often doesn't provide the features a technical writer or other content specialist might want, but it handles most use cases and is something developers are willing to write in.<p>So please, write your documentation in whatever you feel like. As long as it gets written.