{children}
}}>\n{children}
}} />\n );\n};\n```\n\nTo use it with others, adjust `jsxConfig` passed to bundler.\n```ts\nconst jsxConfig = {\n jsxLib: {\n varName: 'HonoJSX',\n package: 'hono/jsx',\n },\n jsxDom: {\n varName: 'HonoDOM',\n package: 'hono/jsx/dom',\n },\n jsxRuntime: {\n varName: '_jsx_runtime',\n package: 'hono/jsx/jsx-runtime',\n },\n}\n```\nand to `getMDXComponent`\n```ts\nconst jsxConfig = { HonoJSX, HonoDOM, _jsx_runtime };\n```\n\n\n#### Cloudflare Workers\n\nWe'd _love_ for this to work in cloudflare workers. Unfortunately cloudflare workers\nhave two limitations that prevent `mdx-bundler` from working in that\nenvironment:\n\n1. Workers can't run binaries. `bundleMDX` uses `esbuild` (a binary) to bundle\n your MDX code.\n2. Workers can't run `eval` or similar. `getMDXComponent` evaluates the bundled\n code using `new Function`.\n\nOne workaround to this is to put your mdx-bundler related code in a different\nenvironment and call that environment from within the Cloudflare worker. IMO,\nthis defeats the purpose of using Cloudflare workers. Another potential\nworkaround is to use WASM from within the worker. There is\n[`esbuild-wasm`](https://esbuild.github.io/getting-started/#install-the-wasm-version)\nbut there are some issues with that package explained at that link. Then there's\n[`wasm-jseval`](https://github.com/maple3142/wasm-jseval), but I couldn't get\nthat to run code that was output from `mdx-bundler` without error.\n\nIf someone would like to dig into this, that would be stellar, but unfortunately\nit's unlikely I'll ever work on it.\n\n#### Next.JS esbuild ENOENT\n\nesbuild relies on `__dirname` to work out where is executable is, Next.JS and\nWebpack can sometimes break this and esbuild needs to be told manually where to\nlook.\n\nAdding the following code before your `bundleMDX` will point esbuild directly at\nthe correct executable for your platform.\n\n```js\nimport path from 'path'\n\nif (process.platform === 'win32') {\n process.env.ESBUILD_BINARY_PATH = path.join(\n process.cwd(),\n 'node_modules',\n 'esbuild',\n 'esbuild.exe',\n )\n} else {\n process.env.ESBUILD_BINARY_PATH = path.join(\n process.cwd(),\n 'node_modules',\n 'esbuild',\n 'bin',\n 'esbuild',\n )\n}\n```\n\nMore information on this issue can be found\n[in this article](https://www.arcath.net/2021/03/mdx-bundler#esbuild-executable).\n\n## Inspiration\n\nAs I was rewriting [kentcdodds.com](https://kentcdodds.com) to\n[remix](https://remix.run), I decided I wanted to keep my blog posts as MDX, but\nI didn't want to have to compile them all at build time or be required to\nredeploy every time I fix a typo. So I made this which allows my server to\ncompile on demand.\n\n## Other Solutions\n\nThere's [next-mdx-remote](https://github.com/hashicorp/next-mdx-remote) but it's\nmore of an mdx-compiler than a bundler (can't bundle your mdx for dependencies).\nAlso it's focused on Next.js whereas this is meta-framework agnostic.\n\n## Issues\n\n_Looking to contribute? Look for the [Good First Issue][good-first-issue]\nlabel._\n\n### π Bugs\n\nPlease file an issue for bugs, missing documentation, or unexpected behavior.\n\n[**See Bugs**][bugs]\n\n### π‘ Feature Requests\n\nPlease file an issue to suggest new features. Vote on feature requests by adding\na π. This helps maintainers prioritize what to work on.\n\n[**See Feature Requests**][requests]\n\n## Contributors β¨\n\nThanks goes to these people ([emoji key][emojis]):\n\n\n\n\n![\"Kent](\"https://avatars.githubusercontent.com/u/1500684?v=3?s=100\") Kent C. Dodds π» π π β οΈ | \n ![\"benwis\"/](\"https://avatars.githubusercontent.com/u/6953353?v=4?s=100\") benwis π π | \n ![\"Adam](\"https://avatars.githubusercontent.com/u/19609?v=4?s=100\") Adam Laycock π» β οΈ π€ π π | \n ![\"Titus\"/](\"https://avatars.githubusercontent.com/u/944406?v=4?s=100\") Titus π€ π π» | \n ![\"Christian](\"https://avatars.githubusercontent.com/u/3107513?v=4?s=100\") Christian Murphy π€ | \n ![\"Pedro](\"https://avatars.githubusercontent.com/u/372831?v=4?s=100\") Pedro Duarte π | \n ![\"Erik](\"https://avatars.githubusercontent.com/u/4396759?v=4?s=100\") Erik Rasmussen π | \n
![\"Omar](\"https://avatars.githubusercontent.com/u/83309085?v=4?s=100\") Omar Syx π | \n ![\"GaΓ«l](\"https://avatars.githubusercontent.com/u/17253950?v=4?s=100\") GaΓ«l HamΓ©on π | \n ![\"Gabriel](\"https://avatars.githubusercontent.com/u/32134586?v=4?s=100\") Gabriel LoiΓ‘cono π» β οΈ | \n ![\"Spencer](\"https://avatars.githubusercontent.com/u/5247455?v=4?s=100\") Spencer Miskoviak π | \n ![\"Casper\"/](\"https://avatars.githubusercontent.com/u/53900565?v=4?s=100\") Casper π» | \n ![\"Apostolos](\"https://avatars.githubusercontent.com/u/803868?v=4?s=100\") Apostolos Christodoulou π | \n ![\"Yordis](\"https://avatars.githubusercontent.com/u/4237280?v=4?s=100\") Yordis Prieto π» | \n
![\"xoumi\"/](\"https://avatars.githubusercontent.com/u/24864287?v=4?s=100\") xoumi π» | \n ![\"Yasin\"/](\"https://avatars.githubusercontent.com/u/25561152?v=4?s=100\") Yasin π» | \n ![\"Mohammed](\"https://avatars.githubusercontent.com/u/22095656?v=4?s=100\") Mohammed 'Mo' Mulazada π | \n ![\"Can](\"https://avatars.githubusercontent.com/u/5196971?v=4?s=100\") Can Rau π | \n ![\"Hosenur](\"https://avatars.githubusercontent.com/u/50978981?v=4?s=100\") Hosenur Rahaman π | \n ![\"Maciek](\"https://avatars.githubusercontent.com/u/58401630?v=4?s=100\") Maciek Sitkowski π | \n ![\"Priyang\"/](\"https://avatars.githubusercontent.com/u/72823974?v=4?s=100\") Priyang π» π | \n
![\"Mosaad\"/](\"https://avatars.githubusercontent.com/u/48773133?v=4?s=100\") Mosaad π | \n ![\"stefanprobst\"/](\"https://avatars.githubusercontent.com/u/20753323?v=4?s=100\") stefanprobst π» β οΈ | \n ![\"Vlad](\"https://avatars.githubusercontent.com/u/8441036?v=4?s=100\") Vlad Moroz π» | \n