Mjml Email Templates

Handles MJML email template rendering in .NET using the Mjml.Net library. Sets up a template system with a shared layout for headers and footers, embeds MJML files as resources, and includes a renderer that does variable substitution before compiling to cross-client HTML. The composer pattern example is solid, keeping strongly-typed business logic separate from template rendering. The layout injection approach (replacing a {{Content}} placeholder) is simple and works well for transactional emails. If you're building signup confirmations, password resets, or billing emails and want something more maintainable than raw HTML strings, this gives you a clean foundation without much ceremony.

skills.sh installs: 513
GitHub stars: 1.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aaronontheweb/dotnet-skills --skill mjml-email-templates --agent claude-code

Installs into .claude/skills of the current project.

Files

MJML Email Templates

When to Use This Skill

Use this skill when:

Building transactional emails (signup, password reset, invoices, notifications)
Creating responsive email templates that work across clients
Setting up MJML template rendering in .NET

Related skills:

aspire/mailpit-integration - Test emails locally with Mailpit
testing/verify-email-snapshots - Snapshot test rendered HTML

Why MJML?

Problem: Email HTML is notoriously difficult. Each email client (Outlook, Gmail, Apple Mail) renders differently, requiring complex table-based layouts and inline styles.

Solution: MJML is a markup language that compiles to responsive, cross-client HTML:

<!-- MJML - simple and readable -->
<mj-section>
  <mj-column>
    <mj-text>Hello {{UserName}}</mj-text>
    <mj-button href="{{ActionUrl}}">Click Here</mj-button>
  </mj-column>
</mj-section>

Compiles to ~200 lines of table-based HTML with inline styles that works everywhere.