Subscribe to 💌 Tiny Improvements, my weekly newsletter for product builders. It's a single, tiny idea to help you build better products.

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.

*It's a flower from a plum tree. Like it?*

SHIP PRODUCTS
THAT MATTER

💌 Tiny Improvements: my weekly newsletter sharing one small yet impactful idea for product builders, startup founders, and indiehackers.

It's your cheat code for building products your customers will love. Learn from the CTO of a Y Combinator-backed startup, with past experience at Google, Stripe, and Microsoft.

    Join the other product builders, and start shipping today!