create docs, and root npm scripts to build, run next dev server for it.

Author: john-raymon

.npmignore

@@ -0,0 +1,8 @@
+node_modules
+.DS_Store
+# dist
+# dist-ssr
+*.local
+
+# docs website
+/docs

docs/.gitignore

@@ -0,0 +1,35 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# vercel
+.vercel

docs/README.md

@@ -0,0 +1,27 @@
+# Example app with MDX
+
+This example shows using [MDX](https://github.com/mdx-js/mdx) as top level pages for your next.js app.
+
+## Preview
+
+Preview the example live on [StackBlitz](http://stackblitz.com/):
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/vercel/next.js/tree/canary/examples/with-mdx)
+
+## Deploy your own
+
+Deploy the example using [Vercel](https://vercel.com?utm_source=github&utm_medium=readme&utm_campaign=next-example):
+
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/git/external?repository-url=https://github.com/vercel/next.js/tree/canary/examples/with-mdx&project-name=with-mdx&repository-name=with-mdx)
+
+## How to use
+
+Execute [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app) with [npm](https://docs.npmjs.com/cli/init) or [Yarn](https://yarnpkg.com/lang/en/docs/cli/create/) to bootstrap the example:
+
+```bash
+npx create-next-app --example with-mdx with-mdx-app
+# or
+yarn create next-app --example with-mdx with-mdx-app
+```
+
+Deploy it to the cloud with [Vercel](https://vercel.com/new?utm_source=github&utm_medium=readme&utm_campaign=next-example) ([Documentation](https://nextjs.org/docs/deployment)).

docs/components/button.js

@@ -0,0 +1,16 @@
+export default function Button({ children }) {
+  return (
+    <button
+      style={{
+        borderRadius: '3px',
+        border: '1px solid black',
+        color: 'black',
+        padding: '0.5em 1em',
+        cursor: 'pointer',
+        fontSize: '1.1em',
+      }}
+    >
+      {children}
+    </button>
+  )
+}

docs/next.config.js

@@ -0,0 +1,6 @@
+const withMDX = require('@next/mdx')({
+  extension: /\.mdx?$/,
+})
+module.exports = withMDX({
+  pageExtensions: ['js', 'jsx', 'mdx'],
+})