cudoc-nextra

Connect cudoc to Nextra while retaining native heading IDs and TOC behavior.

ESM · Node.js 20+

npm install @cudoment/cudoc cudoc-remark cudoc-nextra

import { cudocRemarkPlugins } from "cudoc-nextra"

// In the Nextra configuration:
const mdxOptions = {
  format: "detect",
  remarkPlugins: cudocRemarkPlugins({
    syntax: { headingAnchor: "both", callout: "both" },
  }),
}

Keep the existing Nextra theme mappings and import @cudoment/cudoc/styles.css once. The explicit syntax setup needs no cudoc components. Nextra owns its TOC. For embedding, collect through the actual Nextra compiler, prepare embeds, and add cudoc-remark/embed to rendering.

Choose host, cudoc or both independently for headingAnchor, badge, tableCellList, callout and link. The representative callout is > [!NOTE] Title. Authors do not register cudoc React components in the recommended setup. Syntax-only rendering needs no stored JSON; cross-document embedding requires document collection.

• Usage guide · 한국어 가이드
• Markdown syntax
• Embedding
• Standalone HTML alongside a host
• API reference
• Runnable examples