unified

Project: micromark/micromark-extension-mdx

Package: micromark-extension-mdx@1.0.0

  1. Dependents: 0
  2. micromark extension to support MDX (agnostic to JavaScript)
  1. unified 174
  2. markdown 131
  3. micromark 32
  4. mdx 26
  5. micromark-extension 15
  6. jsx 13
  7. expression 7

micromark-extension-mdx

Build Coverage Downloads Size Sponsors Backers Chat

micromark extension to support MDX (agnostic to JS). Use micromark-extension-mdxjs instead to support MDX.js.

This package provides the low-level modules for integrating with the micromark tokenizer but has no handling of compiling to HTML: go to a syntax tree instead.

When to use this

You should probably use micromark-extension-mdxjs instead, which supports JavaScript. Alternatively, if you don’t want JavaScript-aware parsing, use this package.

If you don’t need all of MDX, the extensions can be used separately:

Install

This package is ESM only: Node 12+ is needed to use it and it must be imported instead of required.

npm:

npm install micromark-extension-mdx

Use

import {micromark} from 'micromark'
import {mdx} from 'micromark-extension-mdx'

const output = micromark('a <b /> c {1 + 1} d', {extensions: [mdx()]})

console.log(output)

Yields:

<p>a  c  d</p>

…which is rather useless: go to a syntax tree with mdast-util-from-markdown and mdast-util-mdx instead.

API

This package exports the following identifiers: mdx. There is no default export.

mdx()

A function that can be called which returns an extension for micromark to parse MDX (can be passed in extensions). There are no options yet.

Contribute

See contributing.md in micromark/.github for ways to get started. See support.md for ways to get help.

This project has a code of conduct. By interacting with this repository, organization, or community you agree to abide by its terms.

License

MIT © Titus Wormer