mdx README

The project's README from github.com/mdx-js/mdx. As one markdown file: README.md.

MDX

Markdown for the component era

Build Coverage Sponsors Backers Chat

MDX is an authorable format that lets you seamlessly write JSX in your markdown documents. You can import components, such as interactive charts or alerts, and embed them within your content. This makes writing long-form content with components a blast. 🚀

import {Chart} from './snowfall.js'
export const year = 2013

# Last year’s snowfall

In {year}, the snowfall was above average.
It was followed by a warm spring which caused
flood conditions in many of the nearby rivers.

<Chart year={year} color="#fcb32c" />

See § What is MDX for more info on the format. See § Playground to try it out.

What is this?

This GitHub repository contains several packages for compiling the MDX format to JavaScript, integrating with bundlers such as webpack and Rollup, and for using it with frameworks such as React, Preact, and Vue.

See § Getting started for how to integrate MDX into your project.

Security

See § Security on our site for information.

Contribute

See § Contribute on our site for ways to get started. See § Support 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.

Sponsor

See § Sponsor on our site for how to help financially.

Vercel

Motif

HashiCorp

GitBook

Gatsby

Netlify

Coinbase

ThemeIsle

Expo

Boost Note

Markdown Space

Holloway


You?

License

MIT © Compositor and Vercel

mdx (mdx-js/mdx)

webpack
Searching Database…

19.8K ·GitHub
What is this?MDX is an authorable format that lets you seamlessly write JSX in your markdown documents — import components like interactive charts or alerts and embed them right in the content.
So is MDX a file format, a library, or an app?A format plus a JavaScript toolchain: this repo holds several packages that compile MDX to JavaScript, so it goes into your project rather than running as a standalone app.
How do I get MDX into an existing project?Add the packages and hook the compiler into your bundler; the README points to the Getting started guide on mdxjs.com for instructions per setup.
Which frameworks and bundlers does it support?It ships integrations for bundlers such as webpack and Rollup, and packages for using it with React, Preact, and Vue.
MDX embeds live code inside content files — any security catch?The README does not go into detail here; it defers security information to a dedicated section on the MDX website.
Do I need to be a React developer to write it?No — the base is plain markdown, so writers keep their usual workflow; developers are the ones adding interactive components, and the project pitches long-form content with components as a blast.
Can I try MDX without installing anything?Yes — the MDX website has a Playground where you can experiment with the format right in the browser before wiring it into a project.
Is MDX a mature project or something new?Mature: the repository was created in December 2017, has about 19.8k stars, and the format is published under the MIT license by Compositor and Vercel.
What are similar projects?mitosis, core, react-markdown, svgr, tamagui, tiptap, rspack, tsrx
Creator
mdx-js
Size
43.6 MB
Stars
19.8K
Age
8y
Commits · 90 Days