# Markdown Pipeline

> Markdown and MDX pipelines with remark rehype - security performance and GFM parity

- Skill: `bh611627/markdown-pipeline` (Agent Skill)
- Install (CLI): `npx skillmds@latest add bh611627/markdown-pipeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bh611627/markdown-pipeline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: bh611627 (https://skillmd.com/u/bh611627)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/bh611627/markdown-pipeline

---


# Instructions

## When to Use

- Use for MDX/Markdown sanitize + GFM pipelines.
- Prefer `content-creator` for social copy, not MDX plumbing.
- Prefer `skillcodex-browser-ui` for the doc browser shell.

Design a **markdown/MDX** rendering pipeline for **docs or blogs** in Next.js.

1. **User-generated content:** sanitize HTML; forbid raw `dangerouslySetInnerHTML` without allowlist.
2. **GFM:** tables, task lists, strikethrough via `remark-gfm`.
3. **Syntax highlight:** server vs client component for Shiki or prism - pick based on bundle budget.
4. **Links:** `rel` on external; heading slug plugin alignment with TOC.
5. **Images:** `next/image` in MDX wrapper components with dimensions.
## Outcomes

- Plugin list + security policy paragraph + component map.

## Output Rules

No unbounded HTML pass-through in examples.

## Scope and boundaries

- **In scope:** rendering stack, sanitization, MDX component whitelist.
- **Out of scope:** full CMS selection, search indexing backend.

## Safety

- Read-only; highlight XSS risks if user content is involved.

## Troubleshooting

- **Hydration on code blocks:** split highlighter to client leaf or use static HTML at build time.
- **MDX eval:** never suggest `eval` or arbitrary component mapping from URL params.

## Related skills

- [`content-creator`](../content-creator/SKILL.md) - copy before pipeline
- [`skillcodex-browser-ui`](../skillcodex-browser-ui/SKILL.md) - doc browser rendering
- [`secure-dependencies`](../secure-dependencies/SKILL.md) - sanitizer library risk

**GitHub:** https://github.com/bh611627/skillcodex/tree/main/skills/markdown-pipeline/SKILL.md  
**npm:** https://www.npmjs.com/package/@skillcodex/skills