diff --git a/README.md b/README.md
index 78419156528b5..4eea5e01e650d 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,7 @@ Websites built with Gatsby:
* [React](https://reactjs.org/) ([source](https://github.com/reactjs/reactjs.org))
* [Sourcegraph](https://about.sourcegraph.com)
* [Simply](https://simply.co.za)
+* [The freeCodeCamp Guide](https://guide.freecodecamp.org)
* [FloydHub's Blog](https://blog.floydhub.com)
* [mParticle's Documentation](https://docs.mparticle.com)
* [Segment's Blog](https://segment.com/blog/)
@@ -69,6 +70,10 @@ Websites built with Gatsby:
* [GRANDstack - GraphQL, React, Apollo, Neo4j Database](http://grandstack.io/)
* [GraphCMS's website](https://graphcms.com)
* [Mannequin.io](https://mannequin.io) ([source](https://github.com/LastCallMedia/Mannequin/tree/master/site))
+* [API Platform](https://api-platform.com) ([source](https://github.com/api-platform/website))
+* [Bottender Docs](https://bottender.js.org/) ([source](https://github.com/bottenderjs/bottenderjs.github.io))
+* [How to GraphQL](https://www.howtographql.com/) ([source](https://github.com/howtographql/howtographql))
+* [greglobinski.com](https://greglobinski.com) ([source](https://github.com/greglobinski/greglobinski-com))
## Docs
diff --git a/examples/using-react-url-query/src/pages/index.js b/examples/using-react-url-query/src/pages/index.js
index b732c0fcf9521..a1c05984ea2c4 100644
--- a/examples/using-react-url-query/src/pages/index.js
+++ b/examples/using-react-url-query/src/pages/index.js
@@ -18,12 +18,14 @@ export default class IndexPage extends React.PureComponent {
The example shows how to use{` `}
react-url-query
- {` `}
+
+ {` `}
for binding url query parameters to props.
- The value of this input is reflected in the URL as the t{` `}
+ The value of this input is reflected in the URL as the t
+ {` `}
query parameter (with a max length of 8).
+ )
+ }
+}
+
+export default Bio
diff --git a/examples/using-remark-copy-linked-files/src/components/profile-pic.jpg b/examples/using-remark-copy-linked-files/src/components/profile-pic.jpg
new file mode 100644
index 0000000000000..3d476d1b4b5ff
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/components/profile-pic.jpg differ
diff --git a/examples/using-remark-copy-linked-files/src/layouts/index.js b/examples/using-remark-copy-linked-files/src/layouts/index.js
new file mode 100644
index 0000000000000..d9372d714c678
--- /dev/null
+++ b/examples/using-remark-copy-linked-files/src/layouts/index.js
@@ -0,0 +1,76 @@
+import React from "react"
+import Link from "gatsby-link"
+import { Container } from "react-responsive-grid"
+
+import { rhythm, scale } from "../utils/typography"
+
+require(`prismjs/themes/prism-solarizedlight.css`)
+
+class Template extends React.Component {
+ render() {
+ const { location, children } = this.props
+ let header
+
+ let rootPath = `/`
+ if (typeof __PREFIX_PATHS__ !== `undefined` && __PREFIX_PATHS__) {
+ rootPath = __PATH_PREFIX__ + `/`
+ }
+
+ if (location.pathname === rootPath) {
+ header = (
+
+
+ Gatsby Starter Blog
+
+
+ )
+ } else {
+ header = (
+
+
+ Gatsby Starter Blog
+
+
+ )
+ }
+ return (
+
+ {header}
+ {children()}
+
+ )
+ }
+}
+
+export default Template
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/Creativecommons-informational-flyer_eng.pdf b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/Creativecommons-informational-flyer_eng.pdf
new file mode 100644
index 0000000000000..c590f0895e82f
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/Creativecommons-informational-flyer_eng.pdf differ
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake- 388538.jpg b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake- 388538.jpg
new file mode 100644
index 0000000000000..22c17e65c5db7
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake- 388538.jpg differ
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-327106.jpg b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-327106.jpg
new file mode 100644
index 0000000000000..8470933d5f42a
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-327106.jpg differ
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-340782.jpg b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-340782.jpg
new file mode 100644
index 0000000000000..c7654f4a1e12c
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-340782.jpg differ
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-388536.jpg b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-388536.jpg
new file mode 100644
index 0000000000000..b477fc6ea6744
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/alex-holyoake-388536.jpg differ
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/gatsbygram.mp4 b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/gatsbygram.mp4
new file mode 100644
index 0000000000000..f4704f0807a0c
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/gatsbygram.mp4 differ
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/index.md b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/index.md
new file mode 100755
index 0000000000000..763f6989dcd22
--- /dev/null
+++ b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/index.md
@@ -0,0 +1,125 @@
+---
+title: "Using gatsby-remark-copy-linked-files"
+excerpt: "Using gatsby-remark-copy-linked-files."
+date: "2017-11-13T10:19:45.267Z"
+draft: false
+path: "/using-gatsby-remark-copy-linked-files/"
+---
+
+Plugin documentation: [gatsby-remark-copy-linked-files](https://www.gatsbyjs.org/packages/gatsby-remark-copy-linked-files/)--_"Copies local files linked to/from markdown to your `public` folder."_
+
+HTML small test (see the [gatsby/#2696](https://github.com/gatsbyjs/gatsby/issues/2696)--_"[gatsby-transformer-remark] Content of inline HTML tags from markdown source is outside of tags in HTML output."_):
+
+_This is a `` HTML tag with some Markdown formatting and inline code and CSS class of `caption`. Styles for the latter are defined in `utils/typography.js`._
+
+## Images
+
+A simple Markdown image tag:
+
+![Markdown image tag](./alex-holyoake-388536.jpg)
+
+The HTML equivalent, with some inline `style`:
+
+
+
+_Two HTML image tags with inline styles in two Markdown paragraphs, image width set to `160px` and `280px` via inline `style`:_
+
+ We interrupt this program to annoy you and make things generally irritating. I cut down trees, I skip and jump, I like to press wildflowers, image #1 should be floating `left`.
+
+Hegel is arguing that the reality is merely an a priori adjunct of non-naturalistic ethics, Kant via the categorical imperative is holding that ontologically it exists only in the imagination, and Marx claims it was offside.
+
+### Markdown Headline `
`
+
+ And whereas in most professions these would be considerable drawbacks, in chartered accountancy, they're a positive boon. Image #2 should be floating `right`. We're not cheap--here's a HTML href example.com on top!
+
+__Paragraph tags with Markdown content__ with two HTML images inline, running across multiple lines: ![inline image](./alex-holyoake-340782.jpg)
+
+
+ HTML Paragraph with two inline images:
+
+ and another one:
+
+
+## Links
+
+A HTML href on a single line:
+
+Download PDF
+
+HTML paragraph with text and HTML href inside:
+
+
+
+A HTML href on three lines – opening tag, inline text, closing tag:
+
+
+ Download PDF
+
+
+Paragraph in regular Markdown and HTML href: Download PDF
+
+Paragraph in regular Markdown and Markdown href: [Download PDF](Creativecommons-informational-flyer_eng.pdf)
+
+## Fails & Wins
+
+_Wins are easily recognizable by either an image or a video being displayed--Fails are marked._
+
+### Markdown Images containing a space
+
+
+
+Here's a Markdown image with space in filename:
+
+![](./alex-holyoake- 388538.jpg)
+
+But: HTML image with space in filename:
+
+
+
+### Embedding Video
+
+HTML video tag with `source` and a fallback paragraph, multiple lines:
+
+
+
+However doing the same in just one line of HTML fails--
+Video, single line:
+
+
+
+## gatsby-config.js
+
+```javascript
+{
+ resolve: `gatsby-transformer-remark`,
+ options: {
+ plugins: [
+ {
+ resolve: `gatsby-remark-responsive-iframe`,
+ options: {
+ wrapperStyle: `margin-bottom: 1.0725rem`,
+ },
+ },
+ 'gatsby-remark-prismjs',
+ {
+ resolve: 'gatsby-remark-copy-linked-files',
+ options: {
+ // `ignoreFileExtensions` defaults to [`png`, `jpg`, `jpeg`, `bmp`, `tiff`]
+ // as we assume you'll use gatsby-remark-images to handle
+ // images in markdown as it automatically creates responsive
+ // versions of images.
+ //
+ // If you'd like to not use gatsby-remark-images and just copy your
+ // original images to the public directory, set
+ // `ignoreFileExtensions` to an empty array.
+ ignoreFileExtensions: [],
+ },
+ },
+ 'gatsby-remark-smartypants',
+ ],
+ },
+},
+```
diff --git a/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/my-name-is-yanick- 87426.jpg b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/my-name-is-yanick- 87426.jpg
new file mode 100644
index 0000000000000..d50dd78199fbc
Binary files /dev/null and b/examples/using-remark-copy-linked-files/src/pages/2017-11-13-gatsby-remark-copy-linked-files/my-name-is-yanick- 87426.jpg differ
diff --git a/examples/using-remark-copy-linked-files/src/pages/index.js b/examples/using-remark-copy-linked-files/src/pages/index.js
new file mode 100644
index 0000000000000..31db7173b041f
--- /dev/null
+++ b/examples/using-remark-copy-linked-files/src/pages/index.js
@@ -0,0 +1,70 @@
+import React from "react"
+import Link from "gatsby-link"
+import get from "lodash/get"
+import Helmet from "react-helmet"
+
+import Bio from "../components/Bio"
+import { rhythm } from "../utils/typography"
+
+class BlogIndex extends React.Component {
+ render() {
+ const siteTitle = get(this, `props.data.site.siteMetadata.title`)
+ const posts = get(this, `props.data.allMarkdownRemark.edges`)
+
+ return (
+