A simple template to easily deploy MDX files.
- Clone the repository or create a repository from the template.
pnpm ipnpm dev
- Uses
mdx-butler - Author mdx files in a
docsfolder or with any file pattern. - File and frontmatter based routing
- A Perfect lighthouse score.
- Support for
MDXsyntax in descriptions, table of contents, headings and more. - 100% static output, resulting in an easy and blazingly fast Deployment to
GitHub Pages,Cloudflare Pages,Netlify,AWSand many other hosting providers. - Full support for custom components and snippets. Import anything in your documents, all files will be bundled in parallel with
mdx-bundlerandesbuild. - Unopinionated styling. Easily add Global CSS, a custom
tailwindconfig or other styling solutions. - Fully Functional responsive layout and
neutralcolor styling out of the box. - No bloat - just the basics with a focus on only adding light-weight dependencies.
- Easy to add analytics, search or other third party implementations.
- Uses
vike+preactfor a small client bundle size (~45kb zipped). Unpicto handle Images.prettierandeslintconfiguration for automatic linting and formatting of files, includingMDXdocuments and Code blocks.
Caution
MDX is javascript. If not carefully done, evaluating user content can expose to XSS attacks.
Always be careful if you are not evaluating your own content.
