Standalone compilation

Use foldocs-mdx/compiler when a script, importer, test, or content adapter needs the typed compiler without starting Vite.

Node.js

import { compile } from 'foldocs-mdx/compiler'
import { readFile } from 'node:fs/promises'

const filePath = 'content/docs/reference.md'
const source = await readFile(filePath, 'utf8')
const page = await compile(source, { filePath })

console.log(page.frontmatter.title)
console.log(page.toc)

Bun

The same API works in Bun. Source text can come from Bun.file(), an HTTP response, a database, or any other build-time input.

import { compile } from 'foldocs-mdx/compiler'

const filePath = 'content/docs/reference.md'
const page = await compile(await Bun.file(filePath).text(), { filePath })

Optional highlighting

Pass highlight: true to use the built-in Shiki highlighter, or provide highlightCode for a compiler-aware integration such as @foldocs/twoslash.

Scope

Standalone compilation returns one CompiledPage. It does not discover a site, build navigation, or emit routes. Use the Vite integration for a complete documentation application.