docs(gatsby-link): add example of passing state

docs/docs/gatsby-link.md

@@ -93,10 +93,40 @@ render () {
 }
 ```
 
-You can also pass state to pages when you navigate e.g. `navigate("/a-path/", { state: { pleasant: "reasonably" }}`
+
 
 Note that `navigate` was previously named `navigateTo`. `navigateTo` is deprecated in Gatsby v2.
 
+## Passing state through Link and Navigate
+
+You can also pass state to pages when you navigate e.g. `navigate("/a-path/", { state: { pleasant: "reasonably" }}`
+
+or  
+
+You can also pass state to pages when you use Link e.g. 
+
+`<Link
+           to="/another-page/"
+           activeStyle={{
+             color: "red",
+           }}
+           state={{
+             pleasant: "reasonably",
+           }}
+         >`
+
+This is accessible from the location object on the new page. e.g.
+
+`
+componentDidMount() {
+  const pleasant = this.props.location.state.pleasant
+  this.setState({
+    pleasant: pleasant
+  })
+}
+`
+
+
 ## Prefixed paths helper
 
 It is common to host sites in a sub-directory of a site. Gatsby lets you [set