diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 [![Stackage LTS](http://stackage.org/package/servant-swagger/badge/lts)](http://stackage.org/lts/package/servant-swagger)
 [![Stackage Nightly](http://stackage.org/package/servant-swagger/badge/nightly)](http://stackage.org/nightly/package/servant-swagger)
 
-This project converts [servant](https://github.com/haskell-servant/servant) APIs into Swagger 2.0 specification.
+This project converts [servant](https://github.com/haskell-servant/servant) APIs into Swagger 2.0 conforming json.
 
 ![servant-swagger robot](http://s16.postimg.org/rndz1wbyt/servant.png)
 
@@ -111,7 +111,7 @@
          "get":{
             "responses":{
                "404":{
-                  "description":"id not found"
+                  "description":"`id` not found"
                },
                "200":{
                   "schema":{
diff --git a/servant-swagger.cabal b/servant-swagger.cabal
--- a/servant-swagger.cabal
+++ b/servant-swagger.cabal
@@ -1,5 +1,5 @@
 name:                servant-swagger
-version:             0.1.1
+version:             0.1.2
 synopsis:            Generate Swagger specification for your servant API.
 description:         Please see README.md
 homepage:            https://github.com/dmjio/servant-swagger
@@ -33,7 +33,7 @@
                      , http-media
                      , lens
                      , servant
-                     , swagger2
+                     , swagger2 >= 1 && <2
                      , text
                      , unordered-containers
   default-language:    Haskell2010
@@ -50,7 +50,7 @@
                   , lens
                   , servant
                   , servant-swagger
-                  , swagger2
+                  , swagger2 >= 1 && <2
                   , text
                   , time
   other-modules:
diff --git a/src/Servant/Swagger/Internal.hs b/src/Servant/Swagger/Internal.hs
--- a/src/Servant/Swagger/Internal.hs
+++ b/src/Servant/Swagger/Internal.hs
@@ -139,16 +139,22 @@
 addResponse :: HttpStatusCode -> Response -> Swagger -> Swagger
 addResponse = addResponseWith (\_old new -> new)
 
+-- | Format given text as inline code in Markdown.
+markdownCode :: Text -> Text
+markdownCode s = "`" <> s <> "`"
+
 addDefaultResponse404 :: ParamName -> Swagger -> Swagger
-addDefaultResponse404 name = addResponseWith (\old _new -> alter404 old) 404 response404
+addDefaultResponse404 pname = addResponseWith (\old _new -> alter404 old) 404 response404
   where
+    name = markdownCode pname
     description404 = name <> " not found"
     alter404 = description %~ ((name <> " or ") <>)
     response404 = mempty & description .~ description404
 
 addDefaultResponse400 :: ParamName -> Swagger -> Swagger
-addDefaultResponse400 name = addResponseWith (\old _new -> alter400 old) 400 response400
+addDefaultResponse400 pname = addResponseWith (\old _new -> alter400 old) 400 response400
   where
+    name = markdownCode pname
     description400 = "Invalid " <> name
     alter400 = description %~ (<> (" or " <> name))
     response400 = mempty & description .~ description400
@@ -304,8 +310,9 @@
       name = "body"
       (defs, ref) = runDeclare (declareSchemaRef (Proxy :: Proxy a)) mempty
       param = mempty
-        & paramName   .~ "body"
-        & paramSchema .~ ParamBody ref
+        & paramName     .~ "body"
+        & paramRequired ?~ True
+        & paramSchema   .~ ParamBody ref
 
 -- =======================================================================
 -- Below are the definitions that should be in Servant.API.ContentTypes
diff --git a/test/Servant/SwaggerSpec.hs b/test/Servant/SwaggerSpec.hs
--- a/test/Servant/SwaggerSpec.hs
+++ b/test/Servant/SwaggerSpec.hs
@@ -91,7 +91,7 @@
                       "schema": { "$ref":"#/definitions/Todo" },
                       "description": ""
                     },
-                  "404": { "description": "id not found" }
+                  "404": { "description": "`id` not found" }
                 },
               "produces": [ "application/json" ],
               "parameters":
@@ -283,7 +283,7 @@
          "get":{
             "responses":{
                "404":{
-                  "description":"username not found"
+                  "description":"`username` not found"
                },
                "200":{
                   "schema":{