We handle this by having some components that don't require much training to use (<Note />, <Warning />, <Function />).

I don't think you have to choose between "can be powerful" and "can be simple."

If you want to lock things down so no one EVER puts code in your docs, Markdoc looks great.