diff --git a/README.md b/README.md
index cc71e72..204ddd1 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,10 @@ a lightweight and portable command-line YAML processor
 The aim of the project is to be the [jq](https://github.com/stedolan/jq) or sed of yaml files.
 
 ## Install
-[Download latest binary](https://github.com/mikefarah/yq/releases/latest) or alternatively:
+```
+brew install yq
+```
+or, [Download latest binary](https://github.com/mikefarah/yq/releases/latest) or alternatively:
 ```
 go get github.com/mikefarah/yq
 ```
diff --git a/docs/index.html b/docs/index.html
index 5fa6e25..03ceca4 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -229,6 +229,13 @@
     <label class="md-nav__title" for="toc">Table of contents</label>
     <ul class="md-nav__list" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#brew-install-yq" title="brew install yq" class="md-nav__link">
+    brew install yq
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#download-latest-binary" title="download latest binary" class="md-nav__link">
     download latest binary
@@ -332,6 +339,13 @@
     <label class="md-nav__title" for="toc">Table of contents</label>
     <ul class="md-nav__list" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#brew-install-yq" title="brew install yq" class="md-nav__link">
+    brew install yq
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#download-latest-binary" title="download latest binary" class="md-nav__link">
     download latest binary
@@ -366,6 +380,7 @@
                 <h1 id="yq">yq<a class="headerlink" href="#yq" title="Permanent link">&para;</a></h1>
 <p>yq is a lightweight and portable command-line YAML processor</p>
 <p>The aim of the project is to be the <a href="https://github.com/stedolan/jq">jq</a> or sed of yaml files.</p>
+<h3 id="brew-install-yq">brew install yq<a class="headerlink" href="#brew-install-yq" title="Permanent link">&para;</a></h3>
 <h3 id="download-latest-binary"><a href="https://github.com/mikefarah/yq/releases/latest">download latest binary</a><a class="headerlink" href="#download-latest-binary" title="Permanent link">&para;</a></h3>
 <h3 id="get-the-source">get the source<a class="headerlink" href="#get-the-source" title="Permanent link">&para;</a></h3>
 <pre><code class="bash">go get github.com/mikefarah/yq
diff --git a/docs/search/search_index.json b/docs/search/search_index.json
index eb0307e..3ee7420 100644
--- a/docs/search/search_index.json
+++ b/docs/search/search_index.json
@@ -2,7 +2,7 @@
     "docs": [
         {
             "location": "/",
-            "text": "yq\n\u00b6\n\n\nyq is a lightweight and portable command-line YAML processor\n\n\nThe aim of the project is to be the \njq\n or sed of yaml files.\n\n\ndownload latest binary\n\u00b6\n\n\nget the source\n\u00b6\n\n\ngo get github.com/mikefarah/yq\n\n\n\n\n.zip\n or \ntar.gz\n\n\nView on GitHub",
+            "text": "yq\n\u00b6\n\n\nyq is a lightweight and portable command-line YAML processor\n\n\nThe aim of the project is to be the \njq\n or sed of yaml files.\n\n\nbrew install yq\n\u00b6\n\n\ndownload latest binary\n\u00b6\n\n\nget the source\n\u00b6\n\n\ngo get github.com/mikefarah/yq\n\n\n\n\n.zip\n or \ntar.gz\n\n\nView on GitHub",
             "title": "Install"
         },
         {
@@ -10,6 +10,11 @@
             "text": "yq is a lightweight and portable command-line YAML processor  The aim of the project is to be the  jq  or sed of yaml files.",
             "title": "yq"
         },
+        {
+            "location": "/#brew-install-yq",
+            "text": "",
+            "title": "brew install yq"
+        },
         {
             "location": "/#download-latest-binary",
             "text": "",
diff --git a/docs/sitemap.xml b/docs/sitemap.xml
index 6d95de8..4f0e27b 100644
--- a/docs/sitemap.xml
+++ b/docs/sitemap.xml
@@ -4,7 +4,7 @@
     
     <url>
      <loc>/</loc>
-     <lastmod>2017-12-19</lastmod>
+     <lastmod>2017-12-25</lastmod>
      <changefreq>daily</changefreq>
     </url>
     
@@ -12,7 +12,7 @@
     
     <url>
      <loc>/read/</loc>
-     <lastmod>2017-12-19</lastmod>
+     <lastmod>2017-12-25</lastmod>
      <changefreq>daily</changefreq>
     </url>
     
@@ -20,7 +20,7 @@
     
     <url>
      <loc>/write/</loc>
-     <lastmod>2017-12-19</lastmod>
+     <lastmod>2017-12-25</lastmod>
      <changefreq>daily</changefreq>
     </url>
     
@@ -28,7 +28,7 @@
     
     <url>
      <loc>/create/</loc>
-     <lastmod>2017-12-19</lastmod>
+     <lastmod>2017-12-25</lastmod>
      <changefreq>daily</changefreq>
     </url>
     
@@ -36,7 +36,7 @@
     
     <url>
      <loc>/convert/</loc>
-     <lastmod>2017-12-19</lastmod>
+     <lastmod>2017-12-25</lastmod>
      <changefreq>daily</changefreq>
     </url>
     
@@ -44,7 +44,7 @@
     
     <url>
      <loc>/merge/</loc>
-     <lastmod>2017-12-19</lastmod>
+     <lastmod>2017-12-25</lastmod>
      <changefreq>daily</changefreq>
     </url>
     
diff --git a/mkdocs/index.md b/mkdocs/index.md
index af7ea0a..ba4273c 100644
--- a/mkdocs/index.md
+++ b/mkdocs/index.md
@@ -3,14 +3,14 @@ yq is a lightweight and portable command-line YAML processor
 
 The aim of the project is to be the [jq](https://github.com/stedolan/jq) or sed of yaml files.
 
-### [download latest binary](https://github.com/mikefarah/yq/releases/latest)
-
-### get the source
-```bash
+## Install
+```
+brew install yq
+```
+or, [Download latest binary](https://github.com/mikefarah/yq/releases/latest) or alternatively:
+```
 go get github.com/mikefarah/yq
 ```
 
-[.zip](https://github.com/mikefarah/yq/zipball/master) or [tar.gz](https://github.com/mikefarah/yq/tarball/master)
-
 [View on GitHub](https://github.com/mikefarah/yq)