Join other builders — Get tips from a YC startup founder & ex-Googler. Subscribe to 💌 Tiny Improvements

MDX - I should have done this sooner

I added support for mdx to my site, and it's made life much bettter.

As of this very post, I've added support for MDX to my site. It should make writing new content much easier for me. By removing lots of process that has proven unnecessary, I'll be able to get back to writing more here, an I'm very excited about that.

And it works great! Here's an example of a custom shortcode I wrote, called <Aside />:

And the relevant code for Aside:

1
const Aside = (props) => {
2
const theme = useTheme();
3
return (
4
<Box
5
borderLeft="8px solid"
6
padding="1rem 0 1rem 2rem"
7
borderColor={theme.colors.pink[400]}
8
backgroundColor={theme.colors.pink[50]}
9
margin="2rem 0 2rem 0rem"
10
{...props}
11
/>
12
);
13
};

Its use is fairly simple, too -

1
<Aside>These can be used to highlight important things.</Aside>

h/t

This is on the heels of last night's (now defunct) Reactadelphia Meetup, where a very talented developer named Prince gave a fantastic talk on MDX. I found it particularly inspiring -- it was that rare talk which had substance and motivation. I already had a pretty good grasp of what one might use MDX for in practice, but Prince made some great points about why MDX is such a game changer.

***
Mike Bifulco headshot

💌 Tiny Improvements Newsletter

Subscribe and join other builders

My weekly newsletter for product builders. It's a single, tiny idea to help you build better products.

    Once a week, straight from me to you. 😘 Unsubscribe anytime.


    Get in touch to → Sponsor Tiny Improvements