Make sure to use custom Description component so we have markdown

example/swagger-files/types.json

@@ -26,6 +26,10 @@
                     "type": "string",
                     "description": "This is a string with a description"
                   },
+                  "string with markdown description": {
+                    "type": "string",
+                    "description": "This is a string with a **markdown** description: [link](ref:action-object)"
+                  },
                   "string without description": {
                     "type": "string"
                   },

packages/api-explorer/__tests__/Params.test.jsx

@@ -2,6 +2,8 @@ const React = require('react');
 const { mount } = require('enzyme');
 const extensions = require('@readme/oas-extensions');
 
+const Description = require('../src/form-components/DescriptionField');
+
 const createParams = require('../src/Params');
 
 const Oas = require('../src/lib/Oas');
@@ -34,6 +36,15 @@ describe('form id attribute', () => {
   });
 });
 
+test('should use custom description component', () => {
+  const params = mount(
+    <div>
+      <Params {...props} />
+    </div>,
+  );
+  expect(params.find(Description).length).toBe(1);
+});
+
 test('boolean should render as <select>', () => {
   const params = mount(
     <div>

packages/api-explorer/src/Params.jsx

@@ -7,7 +7,7 @@ const FileWidget = require('react-jsonschema-form/lib/components/widgets/FileWid
 const DateTimeWidget = require('react-jsonschema-form/lib/components/widgets/DateTimeWidget')
   .default;
 
-// const DescriptionField = require('./form-components/DescriptionField');
+const DescriptionField = require('./form-components/DescriptionField');
 const createBaseInput = require('./form-components/BaseInput');
 const createSelectWidget = require('./form-components/SelectWidget');
 const createArrayField = require('./form-components/ArrayField');
@@ -63,7 +63,7 @@ function Params({
             return onChange({ [schema.type]: form.formData });
           }}
           fields={{
-            //  DescriptionField,
+            DescriptionField,
             ArrayField,
             SchemaField,
           }}

packages/api-explorer/src/form-components/DescriptionField.jsx

@@ -1,15 +1,14 @@
-// Modified version of https://github.com/mozilla-services/react-jsonschema-form/blob/2d390f6e56d5c54e715c5daa8b0610be5c62e91e/src/components/fields/DescriptionField.js
+// Modified version of https://github.com/mozilla-services/react-jsonschema-form/blob/aadbbe9701c4db9df761e86f0280e1ecafc509f8/src/components/fields/DescriptionField.js
 const React = require('react');
 const PropTypes = require('prop-types');
 
 const markdown = require('../lib/markdown');
 
 function DescriptionField(props) {
   const { id, description } = props;
-  if (!description) {
-    // See #312: Ensure compatibility with old versions of React.
-    return null;
-  }
+
+  if (!description) return null;
+
   if (typeof description === 'string') {
     return (
       <p
@@ -20,6 +19,7 @@ function DescriptionField(props) {
       />
     );
   }
+
   return (
     <div id={id} className="field-description">
       {description}