# markdown-mdx-content-pipeline-wasp-drone

markdown-mdx-content-pipeline-wasp-drone — a subagent for building and reviewing Markdown/MDX pipelines from source files to HTML, JSX, or React output. Use it for compilers, plugin chains, highlighting, math, diagrams, and sanitization.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 96 repo stars
- Author: Legion Code Inc.
- License: AGPL-3.0-or-later · policy=link-only · description only; the file stays with the author
- Source: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/agents/markdown-mdx-content-pipeline-wasp-drone.md
- Updated: 2026-10-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/markdown-mdx-content-pipeline-wasp-drone

## What it does

This subagent covers the path from `.md` and `.mdx` files to rendered HTML, JSX, or React output. It can help choose Velite, `@next/mdx`, or `@mdx-js/mdx`, arrange remark and rehype stages, configure GFM, work with ASTs, and set up Shiki v4, expressive-code, or starry-night.

It also handles typed custom plugins, KaTeX math, Mermaid and D2 diagrams, plus `rehype-sanitize` and DOMPurify. For a new pipeline, it can outline fixtures and XSS checks. The plugin order matters: `rehypeSanitize` must follow `rehypeRaw`, or raw HTML can reach the next stage without the intended filtering.

The subagent runs with Claude Code and Codex. User-authored Markdown requires sanitization settings; documentation-platform choice and the `mdx-components.tsx` component map belong to other subagents.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
In the agent chat (not a shell):
```text
/plugin install documentation-tools@wasp-nest
```

2. **Manually: put the files in place**
- File: `.claude/agents/markdown-mdx-content-pipeline-wasp-drone.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/markdown-mdx-content-pipeline-wasp-drone.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/markdown-mdx-content-pipeline-wasp-drone.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/agents/markdown-mdx-content-pipeline-wasp-drone.md

## When to use it
- choose a compiler for Markdown and MDX
- assemble a remark and rehype plugin chain
- configure code highlighting with Shiki v4
- add KaTeX formulas and Mermaid diagrams
- filter unsafe HTML from user-authored Markdown

## Example prompts
- Set up an MDX processing pipeline for this project and recommend a compiler.
- Review the remark and rehype order, then fix the sanitization setup.
- Add KaTeX formulas and Mermaid diagrams to the Markdown pipeline and create tests.

## Similar
- [mdx-sanitizer](https://affpapa.org/en/nevibecode/skills/mdx-sanitizer.md) — skill · 202 installs
- [markdown-content-creation](https://affpapa.org/en/nevibecode/rules/markdown-content-creation.md) — rule · ★ 41430 repo stars
- [baoyu-markdown-to-html](https://affpapa.org/en/nevibecode/skills/baoyu-markdown-to-html.md) — skill · 32900 installs
- [markdown-to-html](https://affpapa.org/en/nevibecode/skills/markdown-to-html.md) — skill · 9899 installs
- [Markdown to HTML — Headings, Code, Tables](https://affpapa.org/en/nevibecode/mcp/markdown-to-html-headings-code-tables.md) — MCP server · 4038 installs
- [Markdown Renderer — Styled HTML with CSS Themes](https://affpapa.org/en/nevibecode/mcp/markdown-renderer-styled-html-with-css-themes.md) — MCP server · 2621 installs

From the same set: [legioncodeinc/vibe-coding-tools](https://affpapa.org/en/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
