@veryfront/ext-content-mdx

Category: Content | Contract: ContentProcessor | Built-in

Provides MDX and Markdown processing for Veryfront, backed by @mdx-js/mdx and the unified ecosystem. It returns compiled React modules with sanitized HTML output, frontmatter extraction, and heading collection.

Registration

This extension is auto-enabled by core bootstrap. Add it to veryfront.config.ts only when you need to override the built-in registration:

import extMdx from "@veryfront/ext-content-mdx";

export default defineConfig({
  extensions: [extMdx()],
});

Provided contract

ContentProcessor exposes:

• compileMdx(options) runs @mdx-js/mdx through Veryfront's bundled remark + rehype plugin stack and returns compiled ESM, extracted headings, and frontmatter.
• compileMarkdown(options) runs a unified Markdown pipeline (remark-parse to remark-rehype to rehype-sanitize to rehype-stringify) producing sanitized HTML wrapped in a React component.
• getRemarkPlugins() / getRehypePlugins() returns the configured plugin list so callers can build a custom pipeline.

Default plugin stack

| Phase | Plugins | | ------ | ------------------------------------------------------------------------------------------------------------- | | remark | remark-gfm, remark-frontmatter | | rehype | rehype-slug, rehype-highlight, rehype-starry-night, rehype-raw, rehype-sanitize, rehype-stringify |

Pass plugins.remark / plugins.rehype in ContentCompileOptions to extend the stack at the call site.

Configuration

No factory options. The extension reads no environment variables and takes no config.

Behavior when missing

If the extension is not installed and core's MDX or Markdown processor is invoked, Veryfront throws an actionable install message pointing to @veryfront/ext-content-mdx.