How can I use @shikijs/rehype with react-markdown

[HerbertHe]

Validations

• [X] Follow our Code of Conduct
• [X] Read the Contributing Guide.
• [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.

Describe the bug

I tried to use @shikijs/rehype with react-markdown, but I got an error as followed:

• code:

import RehypeShiki from '@shikijs/rehype';

<ReactMarkdown
      remarkPlugins={[RemarkMath, RemarkGFM]}
      rehypePlugins={[
        RehypeKaTeX,
        [
          RehypeShiki,
          {
            themes: {
              light: 'vitesse-light',
              dark: 'vitesse-dark',
            },
          },
        ],
      ]}
      components={{}}
    >
      {content}
    </ReactMarkdown>

Reproduction

follow the document with @shikijs/rehype

Contributes

• [ ] I am willing to submit a PR to fix this issue
• [ ] I am willing to submit a PR with failing tests

[Serpentarius13]

That's probably an issue with Async plugins in react-markdown: https://github.com/remarkjs/react-markdown/issues/680

[liuhq]

@HerbertHe Yesterday, I also got the same issue when using shiki with react-markdown. But it seems that no a solution yet on the react-markdown side. So, I referred to this article, and I think we only need a simple hook and don't necessarily need react-markdown, like below:

Hook useRemark

import { useCallback, useState } from 'react'
import * as jsxRuntime from 'react/jsx-runtime'
import rehypeReact, { type Options as RehypeReactOptions } from 'rehype-react'
import remarkParse, { type Options as RemarkParseOptions } from 'remark-parse'
import remarkRehype, { type Options as RemarkRehypeOptions } from 'remark-rehype'
import { unified, type PluggableList } from 'unified'

export interface UseRemarkOptions {
    remarkParseOptions?: RemarkParseOptions
    remarkPlugins?: PluggableList
    remarkRehypeOptions?: RemarkRehypeOptions
    rehypePlugins?: PluggableList
    rehypeReactOptions?: Pick<RehypeReactOptions, 'components'>
    onError?: (err: Error) => void
}

export default function useRemark({
    remarkParseOptions,
    remarkPlugins = [],
    remarkRehypeOptions,
    rehypePlugins = [],
    rehypeReactOptions,
    onError = () => {},
}: UseRemarkOptions = {}): [React.ReactElement | null, (source: string) => void] {
    const [content, setContent] = useState<React.ReactElement | null>(null)

    const setMarkdown = useCallback((source: string) => {
        unified()
            .use(remarkParse, remarkParseOptions)        // parse markdown
            .use(remarkPlugins)
            .use(remarkRehype, remarkRehypeOptions)      // markdown to html
            .use(rehypePlugins)
            .use(rehypeReact, {                          // html to react elements
                ...rehypeReactOptions,
                Fragment: jsxRuntime.Fragment,
                jsx: jsxRuntime.jsx,
                jsxs: jsxRuntime.jsxs,
            } satisfies RehypeReactOptions)
            .process(source)
            .then(vfile => setContent(vfile.result))     // get react elements
            .catch(onError)
    }, [])

    return [content, setMarkdown]
}

you just need to add the pkg of unified, remark-parse, remark-rehype, rehype-react

Usage

const [markdown, setMarkdown] = useRemark({
    rehypePlugins: [
        [rehypeShiki, { theme: 'catppuccin-mocha' } satisfies RehypeShikiOptions]
    ],
})

if (markdown == null) {
    setMarkdown(source) // markdown source string
}

return <article>{markdown}</article>

---

Hopefully, this will be useful to you.