.travis.yml

@@ -14,6 +14,8 @@ cache:
   yarn: true
   directories:
     - node_modules
+before_deploy:
+  - echo "//registry.npmjs.org/:_authToken=\${NPM_AUTH_TOKEN}" >> $HOME/.npmrc 2> /dev/null
 deploy:
   provider: script
   script: yarn publish-ci

docs/getting-started/index.md

@@ -107,6 +107,38 @@ browser navigation.
 Avoid this by following the pattern shown above and declare your mapping as a
 constant.
 
+### Table of components
+
+The following components are rendered from Markdown, so these can be keys
+in the component object you pass to MDXProvider.
+
+| Tag             | Name                                                                 | Syntax                                              |
+| --------------- | -------------------------------------------------------------------- | --------------------------------------------------- |
+| `p`             | [Paragraph](https://github.com/syntax-tree/mdast#paragraph)          |                                                     |
+| `h1`            | [Heading 1](https://github.com/syntax-tree/mdast#heading)            | `#`                                                 |
+| `h2`            | [Heading 2](https://github.com/syntax-tree/mdast#heading)            | `##`                                                |
+| `h3`            | [Heading 3](https://github.com/syntax-tree/mdast#heading)            | `###`                                               |
+| `h4`            | [Heading 4](https://github.com/syntax-tree/mdast#heading)            | `####`                                              |
+| `h5`            | [Heading 5](https://github.com/syntax-tree/mdast#heading)            | `#####`                                             |
+| `h6`            | [Heading 6](https://github.com/syntax-tree/mdast#heading)            | `######`                                            |
+| `thematicBreak` | [Thematic break](https://github.com/syntax-tree/mdast#thematicbreak) | `***`                                               |
+| `blockquote`    | [Blockquote](https://github.com/syntax-tree/mdast#blockquote)        | `>`                                                 |
+| `ul`            | [List](https://github.com/syntax-tree/mdast#list)                    | `-`                                                 |
+| `ol`            | [Ordered list](https://github.com/syntax-tree/mdast#list)            | `1.`                                                |
+| `li`            | [List item](https://github.com/syntax-tree/mdast#listitem)           |                                                     |
+| `table`         | [Table](https://github.com/syntax-tree/mdast#table)                  | `--- | --- | ---`                                   |
+| `tr`            | [Table row](https://github.com/syntax-tree/mdast#tablerow)           | `This | is | a | table row`                         |
+| `td`/`th`       | [Table cell](https://github.com/syntax-tree/mdast#tablecell)         |                                                     |
+| `pre`           | [Pre](https://github.com/syntax-tree/mdast#code)                     |                                                     |
+| `code`          | [Code](https://github.com/syntax-tree/mdast#code)                    |                                                     |
+| `em`            | [Emphasis](https://github.com/syntax-tree/mdast#emphasis)            | `_emphasis_`                                        |
+| `strong`        | [Strong](https://github.com/syntax-tree/mdast#strong)                | `**strong**`                                        |
+| `delete`        | [Delete](https://github.com/syntax-tree/mdast#delete)                | `~~strikethrough~~`                                 |
+| `code`          | [InlineCode](https://github.com/syntax-tree/mdast#inlinecode)        |                                                     |
+| `hr`            | [Break](https://github.com/syntax-tree/mdast#break)                  | `---`                                               |
+| `a`             | [Link](https://github.com/syntax-tree/mdast#link)                    | `<https://mdxjs.com>` or `[MDX](https://mdxjs.com)` |
+| `img`           | [Image](https://github.com/syntax-tree/mdast#image)                  | `![alt](https://mdx-logo.now.sh)`                   |
+
 ### Updating the mapping object during application runtime
 
 If you need to change the mapping during runtime, declare it on the componentʼs

docs/projects.md

@@ -18,6 +18,7 @@
 *   [ZEIT Docs][zeit-docs]
 *   [Compositor][compositor]
 *   [Prisma][prisma]
+*   [Max Stoiber’s Blog][mxstbr]
 
 ## Other related links
 
@@ -39,6 +40,8 @@
 
 [prisma]: https://www.prisma.io/docs
 
+[mxstbr]: https://mxstbr.com/blog
+
 [awesome-mdx]: https://github.com/transitive-bullshit/awesome-mdx
 
 [spectacle-boilerplate-mdx]: https://github.com/FormidableLabs/spectacle-boilerplate-mdx

examples/gatsby/.gitignore

@@ -0,0 +1,3 @@
+node_modules
+.cache
+public

examples/gatsby/gatsby-config.js

@@ -0,0 +1,12 @@
+module.exports = {
+  plugins: [
+    {
+      resolve: 'gatsby-mdx',
+      options: {
+        defaultLayouts: {
+          default: require.resolve('./src/components/Layout')
+        }
+      }
+    }
+  ]
+}

examples/gatsby/package.json

@@ -0,0 +1,15 @@
+{
+  "private": true,
+  "name": "gatsby",
+  "scripts": {
+    "start": "gatsby develop",
+    "build": "gatsby build"
+  },
+  "dependencies": {
+    "@mdx-js/mdx": "^0.16.8",
+    "@mdx-js/tag": "^0.16.8",
+    "gatsby": "^2.0.98",
+    "gatsby-mdx": "^0.3.5",
+    "unified-ui": "^0.0.3"
+  }
+}

examples/gatsby/readme.md

@@ -0,0 +1,5 @@
+# Gatsby + MDX
+
+```sh
+yarn && yarn start
+```

examples/gatsby/src/components/Layout.js

@@ -0,0 +1,17 @@
+import React from 'react'
+import {Container, baseStyles} from 'unified-ui'
+
+const Style = ({children}) => (
+  <style
+    dangerouslySetInnerHTML={{
+      __html: children
+    }}
+  />
+)
+
+export default props => (
+  <>
+    <Style>{baseStyles}</Style>
+    <Container {...props} />
+  </>
+)

examples/gatsby/src/pages/index.mdx

@@ -0,0 +1 @@
+# Hello, world!