Don't write documentation in Markdown
This is missing the point.The goal is "please write your documentation." What solution has the least friction around that for engineers? Right now, it's overwhelmingly Markdown.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.So please, write your documentation in whatever you feel like. As long as it gets written.