diff --git a/docs/source/conf.py b/docs/source/conf.py
index 1fac727c236f387f6ec43dd8f1f1e03d2d31158a..be9668b235f6c4fcbb3f806d247e39f5bed5e8ad 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -10,6 +10,9 @@ master_doc = 'index'
 napoleon_google_docstring = False
 napoleon_numpy_docstring = True
 napoleon_use_ivar = True
+napoleon_use_admonition_for_notes = True
+napoleon_use_admonition_for_examples = True
+napoleon_use_admonition_for_references = True
 
 project = u'NIFTy5'
 copyright = u'2013-2019, Max-Planck-Society'