diff --git a/mlir/utils/vim/README b/mlir/utils/vim/README
index d9a1f7f3da52..78cefde4c90d 100644
--- a/mlir/utils/vim/README
+++ b/mlir/utils/vim/README
@@ -7,3 +7,11 @@ and indentation plugins (indent).
 
 To install, copy all subdirectories to your $HOME/.vim/, or if you
 prefer, create symlinks to the files here.
+
+To enable highlighting inside the Markdown docs, one can add
+
+```
+let g:markdown_fenced_languages = ['mlir']
+```
+
+to `.vimrc`.