mdx-runtime
通过 MDX 运行时存储库(文档/博客/项目)渲染 MdxRemote + next-mdx-remote-client。 Dùng khi làm nội dung MDX,清理,hoặc 地图组件 cho MDX。
📖 中文导读:通过 MDX 运行时存储库(文档/博客/项目)渲染 MdxRemote + next-mdx-remote-client。 Dùng khi làm nội dung MDX,清理,hoặc 地图组件 cho MDX。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: mdx-runtime description: Render và xử lý nội dung MDX runtime trong repo (docs/blog/projects), dùng MdxRemote + next-mdx-remote-client. Dùng khi làm nội dung MDX, sanitize, hoặc map components cho MDX.
MDX runtime
Khi nào dùng skill này
- Khi bạn nói: “render MDX từ database”, “MDX Remote”, “docs content”, “MDX components”, “sanitize MDX”.
Repo patterns
- Component render MDX:
apps/web/src/components/docs/mdx-remote.tsx(exportMdxRemote). - Data source: Supabase (nội dung MDX string trong DB), fetch qua
apps/web/src/services/docs-service.ts(docs) vàapps/web/src/services/blog-service.ts(blog nếu có content MDX).
Checklist khi render MDX
- Ưu tiên Server Component.
- Nội dung đến từ DB: luôn xử lý theo pattern hiện có (sanitization/transform) trước khi render.
- Dùng
MdxRemotethay vì tựdangerouslySetInnerHTML.
Khi sửa/extend MDX components
- Tìm
componentsmapping trongapps/web/src/components/docs/mdx-remote.tsx. - Chỉ thêm mapping tối thiểu cần thiết.
- UI text (nếu có) phải lấy từ
next-intlvà tiếng Việt.
Không được làm
- Không render raw HTML trực tiếp từ DB bằng
dangerouslySetInnerHTML. - Không tự ý thay đổi pipeline MDX (remark/rehype) nếu không có yêu cầu rõ ràng; ưu tiên theo pattern đang dùng.