diff --git a/doc/virtual-libraries.rst b/doc/virtual-libraries.rst
index b833be2441c..18e232a46bd 100644
--- a/doc/virtual-libraries.rst
+++ b/doc/virtual-libraries.rst
@@ -49,10 +49,12 @@ library and may use all the other fields. A virtual library may include other
 modules (with or without implementations), which is why it's not a pure
 "interface" library.
 
-Note: the ``virtual_modules`` field is not merged in ``modules``, which
-represents the total set of modules in a library. If a directory has more than
-one stanza and thus a ``modules`` field must be specified, virtual modules
-still need to be added in ``modules``.
+.. note::
+
+   The ``virtual_modules`` field is not merged in ``modules``, which represents
+   the total set of modules in a library. If a directory has more than one
+   stanza and thus a ``modules`` field must be specified, virtual modules still
+   need to be added in ``modules``.
 
 Implementation
 ===============