MDX to Markdown

Overview

Use this skill to produce plain Markdown from MDX without requiring the target renderer to understand MDX imports, JSX components, Rspress anchors, or code-block metadata.

Workflow

1. Identify the source .mdx and target .md path. If the user gives only a source path, default the output to the same path with .md.
2. Inspect the MDX for non-Markdown constructs:
   • YAML frontmatter.
   • top-level import lines.
   • custom components such as <BlogAuthors /> and <PackageManagerTabs />.
   • heading anchors like ### Title \{#title}.
   • standalone HTML anchors like <a id="title"></a>.
   • fenced code block titles such as a JavaScript fence with title="env.js".
   • HTML image wrappers such as centered <div><img ... /></div>.
3. Run the helper script when the requested conversion matches the default rules: