diff --git a/source/_docs/blueprint/schema.markdown b/source/_docs/blueprint/schema.markdown
index 90f2c105fd1..a0e7c06a129 100644
--- a/source/_docs/blueprint/schema.markdown
+++ b/source/_docs/blueprint/schema.markdown
@@ -45,8 +45,8 @@ description:
   description: >
     The description of the blueprint. While optional, this field is highly
     recommended. For example, to describe what the blueprint does, or tell more
-    about the options inputs of the blueprint provide. New lines in this
-    description are displayed in the UI, so paragraphs are allowed.
+    about the options inputs of the blueprint provide. The description can
+    include [Markdown](https://commonmark.org/help/).
   type: string
   required: false
 domain: