Skip to content

Instantly share code, notes, and snippets.

@ribeiroevandro
Created January 13, 2026 19:51
Show Gist options
  • Select an option

  • Save ribeiroevandro/8070981ecc221e85e6c502ad5c504146 to your computer and use it in GitHub Desktop.

Select an option

Save ribeiroevandro/8070981ecc221e85e6c502ad5c504146 to your computer and use it in GitHub Desktop.

Aplicação de Fontes Customizadas em E-mail Marketing

Introdução

A aplicação de fontes customizadas em e-mail marketing é um desafio técnico devido às limitações e inconsistências dos diversos clientes de e-mail. Este guia apresenta as melhores práticas para implementar tipografia customizada mantendo a compatibilidade e legibilidade.

Abordagens Principais

1. Web Fonts com Fallback (Abordagem Híbrida)

A técnica mais recomendada é usar @import ou <link> para carregar fontes de serviços como Google Fonts, sempre acompanhadas de fallbacks seguros.

Exemplo de implementação:

@import url('https://fonts.googleapis.com/css2?family=Roboto:wght@400;700&display=swap');

body {
  font-family: 'Roboto', Arial, sans-serif;
}

Ou usando link no HTML:

<link href="https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;600&display=swap" rel="stylesheet">

Compatibilidade de Web Fonts

Cliente de E-mail Suporte
Apple Mail ✅ Completo
iOS Mail ✅ Completo
Outlook para Mac ✅ Completo
Thunderbird ✅ Completo
Gmail (todos) ❌ Renderiza fallback
Outlook Windows ❌ Renderiza fallback
Yahoo Mail ⚠️ Parcial
AOL Mail ⚠️ Parcial

2. Fontes Web-Safe como Base

Sempre inclua fontes seguras no stack de fallback para garantir legibilidade em todos os clientes.

Principais fontes web-safe:

  • Sans-serif: Arial, Helvetica, Verdana, Tahoma, Trebuchet MS
  • Serif: Georgia, Times New Roman, Palatino
  • Monospace: Courier New, Courier

Exemplo de stack completo:

h1 {
  font-family: 'Montserrat', 'Helvetica Neue', Helvetica, Arial, sans-serif;
}

body {
  font-family: 'Open Sans', Arial, Helvetica, sans-serif;
}

3. Técnica de Imagens para Elementos Críticos

Para títulos, chamadas principais ou CTAs onde a tipografia é essencial para a identidade da marca, converta o texto em imagem.

Exemplo:

<img 
  src="titulo-customizado.png" 
  alt="Oferta Especial: 50% de Desconto" 
  style="display:block; max-width:100%; height:auto;"
  width="600"
>

Importantes considerações:

  • Sempre inclua atributos alt descritivos
  • Defina dimensões fixas com width e height
  • Otimize imagens para web (PNG ou JPG)
  • Teste com imagens desabilitadas

Técnicas Avançadas

Uso Condicional com VML (Outlook)

Para oferecer experiências diferenciadas no Outlook:

<!--[if mso]>
<style>
  h1 { font-family: Arial, sans-serif; }
</style>
<![endif]-->

@font-face (Não Recomendado)

Embora tecnicamente possível, @font-face tem suporte ainda mais limitado que web fonts externas e geralmente não vale o esforço.

Melhores Práticas

1. Teste Extensivamente

  • Use ferramentas como Litmus, Email on Acid ou Testi@
  • Teste em pelo menos 10-15 clientes de e-mail diferentes
  • Verifique dispositivos móveis e desktops
  • Teste com imagens bloqueadas

2. Priorize Legibilidade

  • Fontes customizadas nunca devem comprometer a leitura
  • Mantenha tamanhos mínimos (14px para corpo, 22px para títulos)
  • Garanta contraste adequado com o fundo
  • Evite fontes decorativas para textos longos

3. Mantenha Hierarquia Visual

Use pesos e tamanhos diferentes para criar hierarquia mesmo com fontes fallback:

h1 {
  font-size: 28px;
  font-weight: 700;
  line-height: 1.2;
}

h2 {
  font-size: 22px;
  font-weight: 600;
  line-height: 1.3;
}

p {
  font-size: 16px;
  font-weight: 400;
  line-height: 1.5;
}

4. Estratégia Híbrida

Combine diferentes abordagens conforme a importância do elemento:

  • Logo e título principal: Imagem
  • Subtítulos e destaques: Web fonts com fallback
  • Corpo de texto: Fontes web-safe

Exemplo Completo

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <link href="https://fonts.googleapis.com/css2?family=Poppins:wght@400;600;700&display=swap" rel="stylesheet">
  <style>
    body {
      font-family: 'Poppins', Arial, Helvetica, sans-serif;
      font-size: 16px;
      line-height: 1.6;
      color: #333333;
    }
    
    h1 {
      font-family: 'Poppins', Arial, sans-serif;
      font-size: 32px;
      font-weight: 700;
      color: #000000;
    }
    
    .button {
      font-family: 'Poppins', Arial, sans-serif;
      font-size: 18px;
      font-weight: 600;
    }
  </style>
</head>
<body>
  <h1>Seu Título Principal</h1>
  <p>Texto do corpo do e-mail com fonte customizada que terá fallback automático em clientes que não suportam.</p>
  <a href="#" class="button">Call to Action</a>
</body>
</html>

Checklist Final

  • Web fonts carregadas de CDN confiável
  • Stack de fallback completo definido
  • Elementos críticos convertidos em imagem quando necessário
  • Alt text descritivo em todas as imagens
  • Testado em principais clientes de e-mail
  • Legibilidade mantida com imagens desabilitadas
  • Hierarquia visual preservada nos fallbacks
  • Performance otimizada (fontes leves)

Conclusão

A realidade do e-mail marketing exige pragmatismo: a maioria dos profissionais prioriza consistência e entregabilidade sobre customização extrema de fontes. A estratégia mais eficaz combina web fonts para clientes modernos, fallbacks sólidos para compatibilidade universal, e imagens estratégicas para elementos onde a tipografia customizada é absolutamente essencial para a identidade da marca.

Aqui está um guia técnico estruturado em Markdown, pronto para ser utilizado como documentação ou referência em seus projetos de e-mail marketing.


Guia de Implementação: Fontes Customizadas em E-mail Marketing

O uso de fontes personalizadas (Web Fonts) em e-mails exige uma estratégia de fallback robusta, pois o suporte varia drasticamente entre os clientes de e-mail (Outlook, Gmail, Apple Mail).

1. Métodos de Importação

Existem três formas principais de chamar uma fonte externa. O método @import e <link> são os mais comuns para Google Fonts.

Opção A: @import (Recomendado)

Deve ser colocado no topo da sua tag <style> dentro do <head>.

<style>
  @import url('https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;700&display=swap');
</style>

Opção B:

Inserido diretamente no <head> do HTML.

<link href="https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;700&display=swap" rel="stylesheet">

2. A Pilha de Fontes (Stack) e Fallbacks

Nunca declare apenas a fonte customizada. Sempre forneça alternativas "Web Safe" que o sistema operacional do usuário certamente possui.

Exemplo de boa prática:

td {
    font-family: 'Open Sans', Helvetica, Arial, sans-serif;
}

Categorias de Fallback:

  • Sans-serif (Sem serifa): Arial, Helvetica, Verdana.
  • Serif (Com serifa): Georgia, Times New Roman.
  • Monospace: Courier New.

3. Matriz de Compatibilidade

Entender onde sua fonte será exibida ajuda a gerenciar as expectativas de design.

Suporta Web Fonts Não Suporta (Usa Fallback)
Apple Mail (iOS & macOS) Gmail (Web, Android, iOS)
Outlook (apenas macOS) Outlook (Windows - Versões Desktop)
Samsung Mail Yahoo! Mail
Thunderbird AOL

4. Solução de Problemas: O "Bug" do Outlook

O Outlook para Windows tende a ignorar os fallbacks e renderizar tudo em Times New Roman quando encontra uma fonte que não conhece. Para evitar isso, utilizamos comentários condicionais.

O Hack de CSS:

Este código diz: "Se o cliente for Outlook (mso), ignore a fonte customizada e force Arial".


5. Checklist de Melhores Práticas

  1. Limite os pesos: Carregue no máximo dois pesos (ex: 400 e 700). Cada variação aumenta o tempo de carregamento do e-mail.
  2. Alt Text em Imagens: Se for usar uma fonte decorativa em formato de imagem, sempre preencha o atributo alt="" para acessibilidade.
  3. Hospedagem Segura: Certifique-se de que a fonte está em um servidor HTTPS, caso contrário, muitos navegadores irão bloqueá-la por segurança.
  4. Contraste: Garanta que sua fonte de fallback tenha uma legibilidade similar à principal para não quebrar o layout (ex: não troque uma fonte muito larga por uma muito condensada).

Deseja que eu gere um template de e-mail completo (boilerplate) com todas essas configurações aplicadas no código?

Boas práticas para uso de fontes customizadas em e-mail marketing

O uso de fontes customizadas em e-mails exige cuidados especiais, pois o suporte é limitado e inconsistente entre os clientes de e-mail. Este documento reúne as práticas recomendadas no mercado para garantir compatibilidade, legibilidade e boa experiência visual.


1. Limitações de suporte (fundamental)

Diferente do desenvolvimento web, a maioria dos clientes de e-mail não suporta carregamento de fontes externas.

Suporte atual por cliente

Cliente de e-mail Suporte a fontes customizadas
Apple Mail (macOS) ✅ Suporta
iOS Mail ✅ Suporta
Samsung Mail ✅ Suporta
Gmail (web e app) ❌ Não suporta
Outlook (Windows) ❌ Não suporta
Outlook Web ❌ Não suporta

📌 Conclusão: fontes customizadas devem ser tratadas apenas como progressive enhancement.


2. Font stack (obrigatório)

Sempre defina uma cadeia de fontes seguras (fallbacks), garantindo que o e-mail continue legível caso a fonte customizada não seja carregada.

Exemplo:

<style>
  .text {
    font-family: 'Inter', 'Helvetica Neue', Helvetica, Arial, sans-serif;
  }
</style>

3. Uso correto de @font-face

A regra @font-face pode ser utilizada, mas nunca como dependência principal.

Exemplo recomendado

<style>
  @font-face {
    font-family: 'Inter';
    src: url('https://seusite.com/fonts/Inter-Regular.woff2') format('woff2');
    font-weight: normal;
    font-style: normal;
  }

  .text {
    font-family: 'Inter', 'Helvetica Neue', Helvetica, Arial, sans-serif;
  }
</style>

Boas práticas

  • Utilize formatos WOFF ou WOFF2
  • Hospede as fontes em HTTPS
  • URLs públicas, sem autenticação
  • Nunca utilize apenas a fonte customizada

4. Evite Google Fonts via <link>

O uso de Google Fonts com <link> não é confiável em e-mails.

<link href="https://fonts.googleapis.com/css2?family=Inter" rel="stylesheet">

❌ Gmail e Outlook ignoram completamente essa abordagem.


5. Onde usar fontes customizadas com segurança

Recomendado:

  • Títulos
  • Headlines
  • Elementos decorativos

Evitar:

  • Textos longos
  • Conteúdo essencial
  • Botões de CTA principais

6. Alternativa profissional: uso de imagens

Para manter consistência visual da marca:

  • Utilize imagens para logos e headlines
  • Mantenha o texto principal em fontes seguras

⚠ Sempre inclua alt text para acessibilidade.


7. Fontes seguras (email-safe)

Fontes amplamente suportadas:

  • Arial
  • Helvetica
  • Verdana
  • Georgia
  • Times New Roman
  • Tahoma
  • Trebuchet MS

💡 Helvetica e Arial continuam sendo o padrão do mercado.


8. Testes (obrigatórios)

Antes de enviar qualquer campanha:

  • Teste em clientes reais (Gmail, Outlook, iOS)

  • Utilize ferramentas especializadas:

    • Litmus
    • Email on Acid

Resumo

  • ✔ Sempre utilize fallback de fontes
  • ✔ Fontes customizadas são opcionais
  • ✔ Não confie em Google Fonts
  • ✔ Use imagens para branding forte
  • ✔ Texto crítico sempre em fonte segura
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment