diff --git a/docs/user/readme.adoc b/docs/user/readme.adoc
index 4ce05a26c7..d2feac0d73 100644
--- a/docs/user/readme.adoc
+++ b/docs/user/readme.adoc
@@ -2,6 +2,13 @@
 :toc: preamble
 :sectanchors:
 :page-layout: post
+// https://gist.github.com/dcode/0cfbf2699a1fe9b46ff04c41721dda74#admonitions
+:tip-caption: :bulb:
+:note-caption: :information_source:
+:important-caption: :heavy_exclamation_mark:
+:caution-caption: :fire:
+:warning-caption: :warning:
+
 
 
 // Master copy of this document lives in the https://github.com/rust-analyzer/rust-analyzer repository
@@ -40,12 +47,15 @@ By default, the plugin will prompt you to download the matching version of the s
 
 image::https://user-images.githubusercontent.com/9021944/75067008-17502500-54ba-11ea-835a-f92aac50e866.png[]
 
-> Note: to disable this notification put the following to `settings.json`
-> ```json
-{
-    "rust-analyzer.askBeforeDownload": false
-}
-```
+[NOTE]
+====
+To disable this notification put the following to `settings.json`
+
+[source,json]
+----
+{ "rust-analyzer.askBeforeDownload": false }
+----
+====
 
 The server binary is stored in `~/.config/Code/User/globalStorage/matklad.rust-analyzer`.