# mdx-js/mdx

Markdown for the component era

Repository: https://github.com/mdx-js/mdx
Canonical: https://ross.abutalabs.com/products/mdx
Homepage: https://mdxjs.com
Language: JavaScript
License: MIT
License Family: permissive
Topics: mdx, markdown, react, vue, jsx, remark, unified
Last push: 2026-08-25T20:42:13+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 13, longevity 100
- inputs: {"age_days": 3175, "days_push": 8, "days_rel": 369, "gap_med": 315, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 19751, forks 1180 (observed 2026-08-28T04:11:29.153369+00:00)

## What it is
MDX is an authorable format that combines Markdown with JSX, letting you import and embed components like charts or alerts directly in long-form content. This repository contains the compiler packages and integrations (for webpack, Rollup, esbuild, Next.js, Vite, etc.) that compile MDX files to JavaScript for use with React, Preact, Vue, and other JSX runtimes.

## Use cases
- write documentation with embedded React components
- compile markdown files to JavaScript components
- use JSX components inside markdown blog posts
- build a docs site with Next.js or Docusaurus and MDX
- customize how markdown elements render as components
- add interactive charts to long-form technical content

## When to choose
- your project already uses JSX (React, Preact, Vue) and you want component-rich markdown content
- you need a markdown format with imports, exports, and expressions compiled ahead of time with no runtime
- you want remark/rehype plugin extensibility for content transformations

## When to avoid
- you only need plain markdown rendering without components
- your stack does not support JSX or a JSX runtime
- you need non-JavaScript output or a runtime without Node.js tooling

## Facets
- artifact type: library
- maturity: stable
- function: compiler, parser, templating, frontend-framework, documentation
- domain: web-development, frontend, documentation, developer-tools
- platform: cross-platform
- tags: mdx, markdown, jsx, react, vue, remark, unified, esm, bundler-integration, nodejs, javascript

## Member repositories
- mdx-js/mdx (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:29.153369+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:59:51.986120+00:00, confidence not recorded.
  - readme: https://github.com/mdx-js/mdx (fetched 2026-08-28T04:11:29.153369+00:00, sha 0e5aca42301f)
  - homepage: https://mdxjs.com (fetched 2026-08-29T07:58:33.397733+00:00, sha dda062a5994e)
  - site_page: https://mdxjs.com/docs/what-is-mdx (fetched 2026-08-29T07:58:33.407686+00:00, sha 48aa96ebaa65)
  - site_page: https://mdxjs.com/docs/getting-started (fetched 2026-08-29T07:58:33.410527+00:00, sha 5e4e0100506e)
  - site_page: https://mdxjs.com/docs (fetched 2026-08-29T07:58:33.416358+00:00, sha 9cbcbfe75403)
  - site_page: https://mdxjs.com/docs/using-mdx (fetched 2026-08-29T07:58:33.418482+00:00, sha b6c1310f2223)
  - site_page: https://mdxjs.com/docs/extending-mdx (fetched 2026-08-29T07:58:33.423629+00:00, sha 91a0a17c40c1)
  - site_page: https://mdxjs.com/docs/troubleshooting-mdx (fetched 2026-08-29T07:58:33.425916+00:00, sha 51f1973e6f56)
  - site_page: https://mdxjs.com/community/about (fetched 2026-08-29T07:58:33.430023+00:00, sha a83690376217)
- Data as of 2026-08-30T08:39:29.467469+00:00.