[mlir][doc] Escape effects, interfaces, and traits (#76297)

Fixes https://github.com/llvm/llvm-project/issues/76270

.

Thanks to @scottamain for the clear description.


Co-authored-by: Scott Main <scott@modular.com>