Methanol is an opinionated, fully customizable static site generator powered by rEFui and MDX. Designed for speed and clarity, it provides a streamlined environment for technical writing and creative ideas.
Methanol requires nearly zero configuration: simply place your files in pages/ (or docs/) to automatically generate routes, a homepage from index.mdx, and a complete navigation tree.
Core Features
- Automated Routing: Drop MDX files into content directories and let Methanol handle the routing and navigation.
- Component Integration: Author reusable JSX components in
components/and embed them directly within your Markdown. - Fine-grained Control: Manage navigation hierarchy, ordering, and visibil…
Methanol is an opinionated, fully customizable static site generator powered by rEFui and MDX. Designed for speed and clarity, it provides a streamlined environment for technical writing and creative ideas.
Methanol requires nearly zero configuration: simply place your files in pages/ (or docs/) to automatically generate routes, a homepage from index.mdx, and a complete navigation tree.
Core Features
- Automated Routing: Drop MDX files into content directories and let Methanol handle the routing and navigation.
- Component Integration: Author reusable JSX components in
components/and embed them directly within your Markdown. - Fine-grained Control: Manage navigation hierarchy, ordering, and visibility using standard frontmatter.
- Production Ready: Build to optimized static files in
dist/with built-in preview capabilities. - Extensible Pipeline: Easily integrate Pagefind for search and Starry Night for syntax highlighting.
rEFui: HTML + Islands
Methanol leverages rEFui for both server-side HTML generation and client-side interactivity. The majority of your site is shipped as pure static HTML; only interactive client components are hydrated as isolated "islands" where necessary, avoiding the overhead of full-page hydration.