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
A content designer arranging reusable editorial blocks into a polished article layout

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:

Image Galleries

Combine product screens or editorial photos in a balanced gallery. Selecting an image opens the full lightbox.

Product Cards

Use an intent-matched card when the article naturally leads into a specific Homi surface.

FAQs

Frequently asked questions

Do MDX components need to be imported in every post?+

No. Components in the shared MDX registry are available to every blog and engineering article.

Should every article contain a product card?+

No. Add one only when the reader reaches a real decision point and the linked Homi surface is the useful next step.

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

Kristian Elset BøKristian Elset Bø

Buying a vacation home abroad without losing the thread

Keep portal listings, broker messages, documents, and the questions you still cannot answer in one place while you compare homes abroad.

#vacation homes#buying abroad#property search#international property#home buying

Want our product updates? Sign up for our newsletter.

We care about your data. Read our privacy policy.