Back to Blog

Complete Guide to Custom MDX Components

Learn how to create and use reusable React components in your MDX content

k

kristian

Author

min read
#mdx#components#guide

This guide shows you how to create rich, interactive content using our custom MDX component system.

Available Components

TLDR Boxes

Provide a quick summary at the start of your posts:

Key Takeaways

  • Homi helps you organize your property search
  • Collaborate with family members in real-time
  • Track properties through every stage of your journey
  • All your home search data in one place

Callout Boxes

Use callout boxes to highlight important information:

This is an info callout - perfect for tips and helpful information.

Warning callouts grab attention for important notices.

Success callouts celebrate achievements and positive outcomes.

Error callouts help users avoid common mistakes.

Call-to-Action Buttons

Drive user actions with styled CTA components:

CTA Cards

Rich call-to-action cards with feature lists:

Start organizing your home search today

Join thousands of families using Homi to find their perfect home

  • Free to start: No credit card required
  • Collaborate with family: Share and discuss properties together
  • Smart organization: Keep all your property searches in one place
  • Save time & sanity: Stop juggling spreadsheets and screenshots

Newsletter Cards

Capture email subscribers with beautiful newsletter forms:

Get home search tips delivered to your inbox

Weekly insights on finding and buying your perfect property

  • Home search tips: Strategies to find your perfect property
  • Market insights: Stay informed about real estate trends
  • Platform updates: New features and improvements

Feature Grids

Showcase features in an organized grid:

Type Safety

Full TypeScript support for your content and components

Hot Reload

See changes instantly during development

SEO Ready

Built-in metadata and performance optimization

Extensible

Add new components as your needs grow

Quotes

Add credibility with styled quotes:

The MDX component system makes it so easy to create rich, interactive content. Our marketing team loves being able to drop in calls-to-action and feature highlights without touching any code.

Sarah Chen
Senior Developer

Statistics

Show data with impact:

MDX Adoption Metrics

3x
Content Creation Speed
faster than before
98%
Developer Satisfaction
team approval rating
95
Performance Score
lighthouse score

Videos

Embed YouTube or Vimeo videos seamlessly:

Best Practices

  1. Keep components focused - Each component should solve one specific content need
  2. Make them reusable - Design components that work in multiple contexts
  3. Maintain consistency - Use your design system's colors, spacing, and typography
  4. Think mobile-first - Ensure components work well on all screen sizes

Pro Tip: Test your components with different content lengths to ensure they're robust and flexible.

Ready to start using these components in your own content?

About the Author

k

kristian

Founder of homi and real estate enthusiast.

Related Posts

Continue reading with these related articles

Want our product updates? Sign up for our newsletter.

We care about your data. Read our privacy policy.