Programmatic API

Two entry points: run() writes Markdown files to disk, generate() returns structured page objects for library consumers.

run()

Writes files to disk. CLI equivalent.

import { run } from 'moxygen';

await run({
  directory: '/path/to/doxygen/xml',
  output: 'api.md',
  anchors: true,
});

await run({
  directory: '/path/to/doxygen/xml',
  output: 'api-%s.md',
  groups: true,
  sourceRoot: '/path/to/project/src',
});

generate()

Returns GeneratedPage[] without writing to disk. This is what Sourcey uses internally.

import { generate } from 'moxygen';

const pages = await generate({
  directory: '/path/to/doxygen/xml',
  language: 'cpp',
});

for (const page of pages) {
  console.log(page.slug, page.title, page.kind);
  console.log(page.markdown);
}