skills.rest
comarkdown
comarkdownOFFICIAL
Explore all skills by this author →
WebsiteGitHub

migrate-mdc-to-comark

Migrate Nuxt projects from @nuxtjs/mdc to the Comark markdown library.

1.0k|41|Updated Jan 22, 2026
Search Tags:#Markdown#Vue#parser#nuxt#comark#Migration#MDC
One-click install
npx skills add https://github.com/comarkdown/comark --skill migrate-mdc-to-comark
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migrate-mdc-to-comark
Source: https://github.com/comarkdown/comark/tree/main/docs/skills/migrate-mdc-to-comark
Command: npx skills add https://github.com/comarkdown/comark --skill migrate-mdc-to-comark

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading a Nuxt project from @nuxtjs/mdc to Comark requires mapping changed APIs, AST formats, components, and plugin configuration, and doing this by hand is error-prone without a complete reference.

Core Features & Use Cases

  • API Mapping: Provides side-by-side tables for parseMarkdown, createMarkdownParser, stringifyMarkdown/renderMarkdown, and result field changes (body/data to nodes/frontmatter).
  • Nuxt Module Migration: Covers @comark/nuxt configuration, MDCRenderer/MDC/MDCSlot component replacements, defineMarkdownComponent, prose components, and Nuxt UI callout integration.
  • Plugin & Pitfall Guidance: Maps remark/rehype plugins to Comark plugins (shiki, toc, emoji, summary) and lists common pitfalls like sync createMarkdownParser and opt-in emoji.
  • Use Case: A developer upgrading a Nuxt content site asks the AI to convert their mdc.config.ts, MDCRenderer usage, and parser calls to Comark equivalents using this reference.

Quick Start

Migrate my Nuxt project from @nuxtjs/mdc to Comark, updating the parser calls, renderer components, and plugin configuration.

Frequently Asked Questions about migrate-mdc-to-comark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate from @nuxtjs/mdc to Comark?▼

Replace @nuxtjs/mdc with comark for core parsing or @comark/nuxt for the Nuxt module. Update parseMarkdown result access from result.body/result.data to document.nodes/document.frontmatter, and swap MDCRenderer for MarkdownDocument.

What replaces MDCRenderer and MDC components in Comark?▼

MDCRenderer is replaced by MarkdownDocument with a value prop, and the all-in-one MDC component is replaced by Markdown. MDCSlot becomes a native Vue slot, with unwrap="p" replacing mdc-unwrap.

Do my markdown files need changes when migrating to Comark?▼

No. The MDC block and inline component syntax is fully compatible, so existing .md files work unchanged. Only the JavaScript API, AST format, and Nuxt module configuration change.

Does Comark support remark and rehype plugins?▼

No, the unified/remark/rehype pipeline is replaced by Comark's own plugin interface. Use plugins like shiki, toc, emoji, summary, and alert passed as an ordered array in parser options or defineMarkdownComponent.

What features from @nuxtjs/mdc are not supported in Comark?▼

Binding syntax with double curly braces is rendered as plain text, and props binding via parseMarkdown data options has no equivalent. Emoji support is also opt-in rather than enabled by default.

Related Skills

Explore More Software Engineering Skills→
nguyenquy0710nguyenquy0710

Lib/Markdown Folder - Markdown Processing

Convert Markdown content to HTML with syntax highlighting for code blocks.

Community
Basic
andrelandgrafandrelandgraf
20

shiki-code-blocks

Highlight code blocks in Next.js and MDX content using Shiki.

Community
Intermediate
dashkandashkan
1

streamdown

Render streaming Markdown with syntax highlighting, Mermaid diagrams, and math.

Community
Advanced
JaivishChauhanJaivishChauhan
6

content-mdx

Centralize portfolio content management with MDX, Contentlayer, or local JSON in Next.js.

Community
Intermediate