diff --git a/doc/source/_exts/workbooks.py b/doc/source/_exts/workbooks.py
index 6b976741d..04f64b91f 100644
--- a/doc/source/_exts/workbooks.py
+++ b/doc/source/_exts/workbooks.py
@@ -57,12 +57,16 @@ def _workbook_to_rst(name, workbook):
             yield ''
 
         if 'description' in workflow:
-            yield '   {}'.format(workflow['description'])
-            yield ''
+            if len(workflow['description'].split("\n"))>2:
+                for _line in workflow['description'].split("\n"):
+                    _new_line = '   ' + _line
+                    yield _new_line
+            else:
+                yield '   {}'.format(workflow['description'])
+                yield ''
 
         if 'input' in workflow:
-            yield '   Workflow inputs:'
-            yield ''
+            yield "\n   Workflow inputs:\n"
             for input_param in workflow['input']:
                 try:
                     yield '   :input {}: Default: {}'.format(