`@mdx-js/loader`

Webpack loader for MDX.

Installation

npm i -D @mdx-js/loader

Usage

// ...
module: {
  rules: [
    // ...
    {
      test: /\.mdx?$/,
      use: ['babel-loader', '@mdx-js/loader']
    }
  ]
}

The renderer option specifies a string that will be prepended to the generated source allowing for the use of any createElement implementation. By default, that string is:

import React from 'react'
import {mdx} from '@mdx-js/react'

Using the renderer option, one can swap out React for another implementation. The example below wraps a generic JSX compatible function named h.

const renderer = `
import { h } from 'generic-implementation'

const mdx = (function (createElement) {
  return function (name, props, ...children) {
    if (typeof name === 'string') {
      if (name === 'wrapper') return children.map(createElement)
      if (name === 'inlineCode') return createElement('code', props, ...children)
    }

    return createElement(name, props, ...children)
  }
}(h))
`

// ...
module: {
  rules: [
    // ...
    {
      test: /\.mdx?$/,
      use: [
        'babel-loader',
        {
          loader: '@mdx-js/loader'
          options: {
            renderer,
          }
        }
      ]
    }
  ]
}

For more information on why this is required, see this post.

Contribute

See the Support and Contributing guidelines on the MDX website for ways to (get) help.

This project has a Code of Conduct. By interacting with this repository, organisation, or community you agree to abide by its terms.

License

Current Tags

2.0.0-ci.53 ... ci (3 years ago)
3.0.1 ... latest (9 months ago)
2.0.0-rc.2 ... next (3 years ago)

216 Versions

3.0.1 ... 9 months ago
3.0.0 ... a year ago
2.3.0 ... 2 years ago
2.2.1 ... 2 years ago
2.2.0 ... 2 years ago
2.1.5 ... 2 years ago
2.1.4 ... 2 years ago
2.1.3 ... 2 years ago
2.1.2 ... 2 years ago
2.1.1 ... 3 years ago
2.1.0 ... 3 years ago
2.0.0 ... 3 years ago
2.0.0-rc.2 ... 3 years ago
2.0.0-rc.1 ... 3 years ago
2.0.0-ci.53 ... 3 years ago
2.0.0-ci.50 ... 3 years ago
2.0.0-ci.43 ... 3 years ago
2.0.0-ci.42 ... 3 years ago
2.0.0-ci.40 ... 3 years ago
2.0.0-ci.39 ... 3 years ago
2.0.0-ci.35 ... 3 years ago
2.0.0-ci.18 ... 3 years ago
2.0.0-ci.15 ... 3 years ago
2.0.0-ci.8 ... 4 years ago
2.0.0-ci.4 ... 4 years ago
2.0.0-ci.3 ... 4 years ago
2.0.0-next.9 ... 4 years ago
1.6.22 ... 4 years ago
1.6.21 ... 4 years ago
1.6.20 ... 4 years ago
1.6.19 ... 4 years ago
2.0.0-next.8 ... 4 years ago
1.6.18 ... 4 years ago
1.6.17 ... 4 years ago
2.0.0-next.7 ... 4 years ago
1.6.16-ci.0 ... 4 years ago
1.6.16 ... 4 years ago
1.6.15 ... 4 years ago
2.0.0-next.6 ... 4 years ago
1.6.14 ... 4 years ago
2.0.0-next.4 ... 4 years ago
1.6.13-ci.1 ... 4 years ago
1.6.13 ... 4 years ago
1.6.12-ci.2 ... 4 years ago
1.6.12 ... 4 years ago
2.0.0-next.3 ... 4 years ago
1.6.11 ... 4 years ago
1.6.11-ci.0 ... 4 years ago
1.6.10-ci.0 ... 4 years ago
1.6.10 ... 4 years ago
1.6.9-ci.0 ... 4 years ago
1.6.9 ... 4 years ago
1.6.8 ... 4 years ago
1.6.8-ci.4 ... 4 years ago
1.6.7 ... 4 years ago
1.6.7-ci.4 ... 4 years ago
1.6.6 ... 4 years ago
1.6.5 ... 4 years ago
2.0.0-next.1 ... 4 years ago
1.6.4 ... 4 years ago
2.0.0-next.0 ... 4 years ago
1.6.3 ... 4 years ago
1.6.2 ... 4 years ago
1.6.2-ci.1 ... 5 years ago
1.6.1 ... 5 years ago
1.6.0 ... 5 years ago
1.5.9 ... 5 years ago
1.5.9-ci.5 ... 5 years ago
1.5.8 ... 5 years ago
1.5.8-ci.13 ... 5 years ago
1.5.8-alpha.0 ... 5 years ago
1.5.7 ... 5 years ago
1.5.7-alpha.0 ... 5 years ago
1.5.6 ... 5 years ago
1.5.6-alpha.0 ... 5 years ago
1.5.6-ci.0 ... 5 years ago
1.5.5 ... 5 years ago
1.5.4 ... 5 years ago
1.5.3 ... 5 years ago
1.5.2 ... 5 years ago
1.5.1 ... 5 years ago
1.5.0 ... 5 years ago
1.4.5 ... 5 years ago
1.4.4 ... 5 years ago
1.4.3 ... 5 years ago
1.4.2 ... 5 years ago
1.4.1 ... 5 years ago
1.4.0 ... 5 years ago
1.3.2 ... 5 years ago
1.3.1 ... 5 years ago
1.3.0 ... 5 years ago
1.2.2 ... 5 years ago
1.2.1 ... 5 years ago
1.1.6 ... 5 years ago
1.1.5 ... 5 years ago
1.1.4 ... 5 years ago
1.1.2 ... 5 years ago
1.1.2-ci.2 ... 5 years ago
1.1.1 ... 5 years ago
1.1.1-ci.41 ... 5 years ago
1.1.1-ci.27 ... 5 years ago
1.1.1-ci.6 ... 5 years ago
1.1.0 ... 5 years ago
1.0.27-ci.0 ... 5 years ago
1.0.27 ... 5 years ago
1.0.26 ... 5 years ago
1.0.25 ... 5 years ago
1.0.24 ... 5 years ago
1.0.24-ci.5 ... 5 years ago
1.0.24-ci.3 ... 5 years ago
1.0.23 ... 5 years ago
1.0.22 ... 5 years ago
1.0.21 ... 5 years ago
1.0.20 ... 5 years ago
1.0.20-ci.2 ... 6 years ago
1.0.19-ci.5 ... 6 years ago
1.0.19 ... 6 years ago
1.0.18 ... 6 years ago
1.0.16 ... 6 years ago
1.0.16-ci.0 ... 6 years ago
1.0.15 ... 6 years ago
1.0.14 ... 6 years ago
1.0.10 ... 6 years ago
1.0.9 ... 6 years ago
1.0.8 ... 6 years ago
1.0.7 ... 6 years ago
1.0.6 ... 6 years ago
1.0.5-ci.0 ... 6 years ago
1.0.5 ... 6 years ago
1.0.4 ... 6 years ago
1.0.4-ci.0 ... 6 years ago
1.0.3-ci.2 ... 6 years ago
1.0.3 ... 6 years ago
1.0.2 ... 6 years ago
1.0.1 ... 6 years ago
1.0.0-ci.0 ... 6 years ago
1.0.0-rc.4 ... 6 years ago
1.0.0-rc.3 ... 6 years ago
1.0.0-rc.2 ... 6 years ago
1.0.0-rc.0 ... 6 years ago
1.0.0-alpha.17 ... 6 years ago
1.0.0-alpha.16 ... 6 years ago
1.0.0-alpha.15 ... 6 years ago
1.0.0-alpha.13 ... 6 years ago
1.0.0-alpha.11 ... 6 years ago
1.0.0-alpha.10 ... 6 years ago
1.0.0-alpha.9 ... 6 years ago
1.0.0-alpha.8 ... 6 years ago
1.0.0-alpha.7 ... 6 years ago
1.0.0-alpha.6 ... 6 years ago
1.0.0-alpha.5 ... 6 years ago
1.0.0-alpha.1 ... 6 years ago
0.20.3 ... 6 years ago
1.0.0-alpha.0 ... 6 years ago
0.20.2 ... 6 years ago
0.20.1 ... 6 years ago
0.20.0 ... 6 years ago
0.20.0-alpha.0 ... 6 years ago
0.19.0 ... 6 years ago
0.19.0-alpha.0 ... 6 years ago
0.18.2 ... 6 years ago
0.18.1 ... 6 years ago
0.18.0 ... 6 years ago
0.17.5 ... 6 years ago
0.17.4 ... 6 years ago
0.17.3 ... 6 years ago
0.17.0 ... 6 years ago
0.16.8 ... 6 years ago
0.16.6 ... 6 years ago
0.16.5 ... 6 years ago
0.16.4 ... 6 years ago
0.16.3 ... 6 years ago
0.16.2 ... 6 years ago
0.16.1 ... 6 years ago
0.16.0 ... 6 years ago
0.15.7 ... 6 years ago
0.15.6 ... 6 years ago
0.15.5 ... 6 years ago
0.15.4 ... 6 years ago
0.15.3 ... 6 years ago
0.15.3-0 ... 6 years ago
0.15.2 ... 6 years ago
0.15.1 ... 6 years ago
0.15.0 ... 6 years ago
0.15.0-4 ... 6 years ago
0.15.0-3 ... 6 years ago
0.15.0-2 ... 6 years ago
0.15.0-1 ... 6 years ago
0.15.0-0 ... 6 years ago
0.14.1 ... 6 years ago
0.14.0 ... 6 years ago
0.13.1-1 ... 6 years ago
0.13.1-0 ... 6 years ago
0.13.0-0 ... 6 years ago
0.12.0 ... 6 years ago
0.11.1 ... 6 years ago
0.11.1-0 ... 6 years ago
0.11.0 ... 6 years ago
0.11.0-0 ... 6 years ago
0.10.1 ... 6 years ago
0.10.0 ... 6 years ago
0.9.0 ... 7 years ago
0.8.1 ... 7 years ago
0.8.1-0 ... 7 years ago
0.8.0 ... 7 years ago
0.7.4 ... 7 years ago
0.7.3 ... 7 years ago
0.7.2 ... 7 years ago
0.7.0 ... 7 years ago
0.7.0-2 ... 7 years ago
0.7.0-1 ... 7 years ago
0.7.0-0 ... 7 years ago
0.6.0 ... 7 years ago
0.5.0 ... 7 years ago
0.4.1 ... 7 years ago
0.4.0 ... 7 years ago