Remark TS to JS

A remark plugin to transform TypeScript codeblocks into two tabs of codeblock with its JavaScript variant.

Usage

Install dependencies:

npm install fumadocs-docgen oxc-transform

Add oxc-transform to serverExternalPackages in next.config.mjs:

next.config.mjs

import { createMDX } from 'fumadocs-mdx/next';
 
/** @type {import('next').NextConfig} */
const config = {
  reactStrictMode: true,
  serverExternalPackages: ['oxc-transform'],
};
 
const withMDX = createMDX();
 
export default withMDX(config);

Add the remark plugin:

source.config.ts

import { remarkTypeScriptToJavaScript } from 'fumadocs-docgen/remark-ts2js';
import { defineConfig } from 'fumadocs-mdx/config';
 
export default defineConfig({
  mdxOptions: {
    remarkPlugins: [remarkTypeScriptToJavaScript],
  },
});

Finally, make sure to define the required MDX components: Tabs and Tab.

app/docs/[[...slug]]/page.tsx (Fumadocs MDX)

import defaultComponents from 'fumadocs-ui/mdx';
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
 
<Mdx
  components={{
    ...defaultComponents,
    Tabs,
    Tab,
  }}
/>;

You can now enable it on TypeScript/TSX codeblocks, like:

```tsx ts2js
import { ReactNode } from 'react';
 
export default function Layout({ children }: { children: ReactNode }) {
  return <div>{children}</div>;
}
```

import { ReactNode } from 'react';
 
export default function Layout({ children }: { children: ReactNode }) {
  return <div>{children}</div>;
}

Usage

On this page