Example in the docs is broken

Running this code sample from the docs is broken, because unified needs a compiler such as rehype-stringify to run the process method

const unified = require('unified');
const remarkParse = require('remark-parse');
const remarkRehype = require('remark-rehype');
const rehypePrism = require('rehype-prism');

unified()
  .use(remarkParse)
  .use(remarkRehype)
  .use(rehypePrism)
  .process(/* some markdown */);

Furthermore when adding the rehype-stringify compiler the code runs correctly, but the output is not syntax highlighted, it seems that adding rehype-prism doesn’t change the output.

Full code sample:

const fs = require("fs")
const html = require("rehype-stringify")
const unified = require("unified")
const remarkParse = require("remark-parse")
const remarkRehype = require("remark-rehype")
const rehypePrism = require("rehype-prism")

unified()
    .use(remarkParse)
    .use(remarkRehype)
    .use(rehypePrism)
    .use(html)
    .process(fs.readFileSync("./test.md", "utf8"), function(err, file) {
        if (err) throw err
        fs.writeFileSync("test.html", String(file))
    })

[thescientist13]

fwiw, I am observing the same issue as well, in regards to following the docs markdown usage example, e.g.

const rehypePrism = require('@mapbox/rehype-prism');
const remarkParse = require('remark-parse');
const remarkRehype = require('remark-rehype');

const processedMarkdown = await unified()
  .use(remarkParse)
  .use(remarkeRhype)
  .use(rehypePrism)
  .process(markdownContents);

Error: Cannot `process` without `Compiler`

To fix, I would need to add something like rehypeStringify as suggested in the original comment.

[silvenon]

You might be installing the wrong package? The correct one is @mapbox/rehype-prism, not rehype-prism.