On: Don't write documentation in Markdown

[bhaak]

Then you still need somebody who cleans up the documentation afterwards or converts it into your Markdown dialect of choice.

If you have such a person anyway, you can just let other contributors write simple text without any styling to begin with.

[pen2l → bhaak]

1) Due to natural inertia there exists to leave things alone that aren’t overtly broken, I doubt there would be a lot of cases in which people would feel so inclined to convert to a different format

2) If people do need to convert it, at least it’s a simple enough spec that conversion shouldn’t require a Herculean amount of effort (I bet there already exist converters that others have written)

[bhaak → pen2l]

As Markdown is available in a plethora of dialects, it's likely any given converter doesn't work 100% correct with the dialect at hand.

Granted, that's only a weak argument against Markdown. I rarely encountered converters that would work 100% correct for any given textual format.