Skip to content
This repository has been archived by the owner on Jul 13, 2022. It is now read-only.

kentcdodds/remix-mdx

Repository files navigation

DEPRECATED (can you deprecate something that wasn't released?)

You can still totally borrow the ideas from this repo, but we've decided to take a different approach to these problems that I think people will like even better. Stay tuned.

Remix MDX

I'm trying to improve upon built-in MDX support in Remix, but I want to do it outside of Remix. I'm hoping someone can take this over as a separate library and serve the MDX community better than the built-in support does.

We do want to keep it as part of the build to keep things simple (can deploy to anywhere and not have to worry about loading the MDX at runtime). If you want to do it at runtime we've already got mdx-bundler for that. That's not what we're doing here.

Todos:

  • live reload
  • routes within the app/routes directory
  • routes outside the app/routes directory
  • all the route filename conventions (like ., [, and ])
  • customizing the compilation of MDX (plugins etc).
  • importing relative, absolute, and ~-prefixed paths.
  • custom components*
  • add a loader export that responds with the frontmatter

*We already have support for custom components, just make a variable binding in the MDX file called components and that'll work. But it would be more sensible to say people need to export something called components and use that instead. This will be a little tricky, but totally possible.

We're not going to be able to support importing MDX files inside JS files. That's out of scope.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published