There's way too many flavours/dialects of markdown. We should be explicit about which we use in the docs.