diff --git a/api/client-server/create_room.yaml b/api/client-server/create_room.yaml
index 811b1187..a321b0f7 100644
--- a/api/client-server/create_room.yaml
+++ b/api/client-server/create_room.yaml
@@ -173,9 +173,9 @@ paths:
               is_direct:
                 type: boolean
                 description: |-
-                  This flag makes the server set the is_direct flag on the
-                  m.room.member events sent to the users in invite and
-                  invite_3pid. See (Direct Messaging) for more information.
+                  This flag makes the server set the ``is_direct`` flag on the
+                  ``m.room.member`` events sent to the users in ``invite`` and
+                  ``invite_3pid``. See `Direct Messaging`_ for more information.
       responses:
         200:
           description: Information about the newly created room.
diff --git a/event-schemas/schema/m.room.member b/event-schemas/schema/m.room.member
index 06c4fa3b..4f4077a7 100644
--- a/event-schemas/schema/m.room.member
+++ b/event-schemas/schema/m.room.member
@@ -40,7 +40,7 @@ properties:
           - ban
         type: string
       is_direct:
-        description: Flag indicating if the room containing this event was created with the intention of being a direct chat.
+        description: Flag indicating if the room containing this event was created with the intention of being a direct chat. See `Direct Messaging`_.
         type: boolean
       third_party_invite:
         properties: