markdown-mdx-content-pipeline-weapon

Markdown and MDX processing stack — from raw .md/.mdx file to final HTML/JSX/React output. This weapon encodes the 2026 state of the unified/remark/rehype ecosystem, the Shiki family (Shiki v4, expressive-code, starry-night), compiler selection, plugin authoring patterns, math/diagram embedding, and sanitization.

When to use this skill

Activate when markdown-mdx-content-pipeline-guardian is invoked, or when the user asks about any of these:

• Selecting a Markdown/MDX compiler for a Next.js, Astro, Vite, or Node.js project
• Auditing or designing a remark/rehype plugin chain
• Implementing or upgrading syntax highlighting (Shiki, expressive-code, starry-night, rehype-pretty-code)
• Writing custom remark or rehype plugins (visitor pattern, AST manipulation)
• Embedding math (KaTeX, MathJax) or diagrams (Mermaid, D2)
• Configuring sanitization for user-authored Markdown (rehype-sanitize, DOMPurify)
• Testing a unified processing pipeline (vitest fixtures, snapshot tests)
• Migrating from Contentlayer, next-mdx-remote, or Prism/Highlight.js to 2026-recommended alternatives