diff --git a/docs/src/behavior.md b/docs/src/behavior.md
index f33537a8..4e629792 100644
--- a/docs/src/behavior.md
+++ b/docs/src/behavior.md
@@ -104,7 +104,7 @@ You can pass options to the Algolia API by using the `algoliaOptions`
 key. You will find all Algolia API options in their [own documentation][3].
 
 For example, you might want to increase the number of results displayed in the dropdown.
-[`hitsPerPage `set the number of shown hits][4].
+[`hitsPerPage` set the number of shown hits][4].
 
 ```javascript
 docsearch({
@@ -115,10 +115,10 @@ docsearch({
 });
 ```
 
-
 [1]: https://github.com/algolia/autocomplete.js
 
 [2]: https://github.com/algolia/autocomplete.js#options
 
 [3]: https://www.algolia.com/doc/api-reference/api-parameters/
+
 [4]: https://www.algolia.com/doc/api-reference/api-parameters/hitsPerPage/
diff --git a/docs/src/config-file.md b/docs/src/config-file.md
index 5d8eee96..f1b05b65 100644
--- a/docs/src/config-file.md
+++ b/docs/src/config-file.md
@@ -400,8 +400,8 @@ If used, `min_indexed_level` is ignored.
 ### `scrape_start_urls` _Optional_
 
 By default, the crawler will extract content from the pages defined in
-`starts_urls`.  If you do not have any valuable content on your `starts_urls` or that some pages are duplicates from another one, you should set
-this to `false`.
+`start_urls`. If you do not have any valuable content on your `starts_urls` or
+if it's a duplicate of another page, you should set this to `false`.
 
 ```json
 {