Loader renderer option

[axdg]

This fixes #711

• adds the prepend to the Webpack loader's options.
• it removes the inline pragma /* @jsx mdx */ - this is not needed since mdx itself adds this during compilation.
• add to README to reflect changes.

All changes are completely backwards compatible... this would just allow for other frameworks to be used with the loader.

[vercel]

This pull request is automatically deployed with Now.
To access deployments, click Details below or on the icon next to each push.

Latest deployment for this branch: https://mdx-git-fork-axdg-loader-prepend.mdx.now.sh

[johno]

Thanks for the PR! This looks good to me, just a couple nits.

Also, I'm going to think a bit on whether there's a clearer name than prepend for a bit.

• pragma
• renderer
• ... 🤔

cc/ @wooorm (you're always good at naming things 😄)

[axdg]

@johno, I've made the suggested changes.

I agree that prepend is not a great name for the options... renderer is better, but go with whatever you think works.

[axdg]

P.S. I don't like pragma, since this is a little ambiguous (as is the way that the word is used to refer to custom createElement wrappers in the documentation / blog).

From wikipedia:

In computer programming, a directive or pragma (from "pragmatic") is a language construct that specifies how a compiler (or other translator) should process its input.

The pragma in this case would be the directive /* @jsx mdx */, not the actual import / implementation.

[johno]

Yeah, I think I'm liking renderer the most. Let's go with that so it's slightly more specific/descriptive. 🙏

[axdg]

Updated that last commit and the docs (feel free to squash anyway) - renderer seems pretty intuitive to me.

[johno]

Thanks!

[wooorm]

@johno ah sorry I missed this ping! Render is good!