Wróć do Centrum pomocy

Dokumentacja.

FigMail łączy świat designu i kodowania maili. Odczytuje strukturę Auto Layout Twojej ramki w Figmie i generuje tabelaryczny HTML zbudowany według reguł klientów pocztowych: ze stylami inline, fallbackami dla Outlooka i kolumnami, które na mobile układają się jedna pod drugą.

Najważniejsze możliwości

  • ✓ Auto Layout zamieniany na tabele HTML
  • ✓ Obsługa obrazów Retina (@2x)
  • ✓ Fallbacki dla Outlooka (komentarze warunkowe MSO)
  • ✓ Kolumny układające się jedna pod drugą na mobile

Instalacja

Aby zainstalować FigMail bezpośrednio z Figmy:

  1. Otwórz Figmę i przejdź do zakładki Community albo naciśnij Shift + I, żeby otworzyć Resources.
  2. Wyszukaj „FigMail”.
  3. Kliknij Run, żeby od razu zacząć, albo Save, żeby dodać wtyczkę do swojej listy.
Działa w:
Design
FigJam
Slides

Uwaga: Aby zbudować maila, FigMail odczytuje warstwy zaznaczonej ramki. Twoje logowanie i preferencje są przechowywane w lokalnej pamięci wtyczek Figmy.

Poradnik dla projektantów

Jako projektant nie musisz czekać na developerów ani uczyć się tabel HTML. FigMail pozwala kształtować maila — odstępy, typografię, obrazy i linki — bezpośrednio w Figmie.

Bezpośredni eksport

Przejdź od projektu do HTML bez opóźnień przy przekazaniu i bez czekania na developera.

Kontrola nad układem

Twoje ustawienia Auto Layout stają się strukturą tabel HTML.

Obsługa obrazów

Obrazy są eksportowane w 2x, kompresowane i hostowane za Ciebie — albo pobierz je w archiwum ZIP i hostuj samodzielnie.

Sprytne nazywanie warstw

Nazwy warstw trafiają do AI razem z układem, więc możesz dodać w nawiasach krótkie instrukcje. Nie potrzebujesz specjalnych słów kluczowych — po prostu opisz, czego chcesz. AI bierze te wskazówki pod uwagę, ale to sugestie, a nie gwarantowane reguły.

Nazwa warstwy:Social Icons (na mobile w jednym rzędzie)

Prosi AI, żeby na mobile zostawiło te kolumny obok siebie, zamiast układać je jedna pod drugą.

Nazwa warstwy:Hero Section (wyśrodkuj obraz w tle)

Prosi generator o wyśrodkowanie obrazu w tle tej ramki.

Nazwa warstwy:Product Grid (2 kolumny na mobile)

Prosi o siatkę z 2 kolumnami na mobile zamiast domyślnej jednej kolumny.

Złożone ikony i wektory

Czasem ikona składa się z wielu ścieżek wektorowych. Aby wyeksportować ją jako jeden ostry obraz:

  • 1Zaznacz grupę lub ramkę, która zawiera ikonę.
  • 2W prawym panelu kliknij + obok Export.
  • 3FigMail wyeksportuje wtedy całą grupę jako jeden obraz, więc wygląda dokładnie tak, jak w projekcie.

Ramki a grupy

Do budowania struktury układu zawsze wybieraj ramki (Frames). Grupy złożone wyłącznie z prostych wektorów są spłaszczane do jednego obrazu. Ramki z Auto Layout stają się tabelami HTML.

Ukryte warstwy

Warstwy z wyłączoną widocznością (ikona oka) są pomijane. Trzymaj w nich szkice albo alternatywne teksty — nie wpłyną na eksport.

Podstawy projektowania

Typografia i fonty web-safe

Własne fonty (np. Inter czy SF Pro) w Outlooku i niektórych innych klientach często zamieniają się w Times New Roman.

  • ✓FigMail automatycznie dodaje fonty zastępcze web-safe (Arial/Helvetica).
  • •Do tekstu głównego używaj fontów systemowych, żeby wszędzie był czytelny.

Przyciski z Auto Layout

Nie buduj przycisków jako grup „prostokąt + tekst”.

  • ✓Użyj Auto Layout (Shift+A) na warstwie tekstowej.
  • ✓Dodaj wypełnienie i zaokrąglenie rogów bezpośrednio do ramki. Tak powstaje najczystszy kod. Pamiętaj, że Outlook pokazuje rogi przycisków jako kwadratowe.

Cienie i rozmycie (efekty)

CSS box-shadow nie jest obsługiwany w Outlooku.

  • !Unikaj cieni na natywnych elementach, takich jak przyciski.
  • •Jeśli cień jest niezbędny, wyeksportuj cały element jako obraz.

Tryb ciemny i przezroczystość

Twój mail może być oglądany w trybie ciemnym.

  • ✓Do logo i ikon używaj przezroczystych PNG.
  • ✕Unikaj czarnego tekstu na przezroczystym tle (w trybie ciemnym znika).

Strategia układu mobilnego

Myśl kolumnami. FigMail domyślnie układa kolumny na mobile jedna pod drugą.

  • •Wyobraź sobie, jak Twoje bloki ułożą się w jednej linii, jeden pod drugim.

Optymalne wymiary

Trzymaj szerokość projektu między 600px a 640px.

  • ✓To popularna standardowa szerokość, która pasuje do desktopowych i mobilnych klientów pocztowych.

Praca z FigMail

Gdy projekt jest gotowy, wygenerowanie kodu jest proste:

1
Zaznacz główną ramkę projektu maila.
2
Uruchom wtyczkę FigMail.
3
Kliknij „Generate HTML” i poczekaj, aż generowanie się zakończy.
4
Obejrzyj wynik, a potem skopiuj kod, pobierz HTML lub archiwum ZIP albo otwórz maila w edytorze Blocks.

Funkcje AI

Oprócz konwersji projektu jeden do jednego FigMail może podczas generowania zrobić dwie dodatkowe rzeczy: przetłumaczyć maila i poprawić jego układ.

Tłumaczenie

Przetłumacz cały tekst maila na inny język, zachowując oryginalną strukturę projektu i formatowanie.

Jak to działa

  1. 1Kliknij we wtyczce przycisk Translate.
  2. 2Wybierz z listy język docelowy.
  3. 3Kliknij Generate HTML — AI przetłumaczy tekst podczas budowania maila.

Obsługiwane języki

arabskichińskiczeskiduńskiniderlandzkifińskifrancuskiniemieckigreckiwłoskijapońskikoreańskinorweskipolskiportugalskirumuńskirosyjskihiszpańskiszwedzkiturecki

Nie widzisz swojego języka? Napisz do nas, a rozważymy jego dodanie.

Wskazówka: Wybrany język pojawia się jako plakietka obok przycisku Translate. Kliknij ikonę X, żeby go usunąć. Tłumaczenie maszynowe może zawierać błędy, więc ważne maile daj do sprawdzenia native speakerowi.

Poprawa układu

Pozwól AI dopracować i wypolerować projekt ponad dokładny układ z Figmy, przy zachowaniu oryginalnej struktury treści i jej zamysłu.

Jak to działa

Kliknij przycisk Improve Layout (ikona rakiety), żeby włączyć lub wyłączyć tę opcję. Gdy jest włączona, AI może swobodnie:

✓Dopracować odstępy, paddingi i marginesy, żeby hierarchia wizualna była czytelniejsza
✓Dostroić typografię lepszymi rozmiarami fontów i interlinią
✓Poprawić kontrast kolorów i równowagę wizualną
✓Ulepszyć styl przycisków lepszymi paddingami i obramowaniami
✓Dodać subtelne cienie, obramowania lub elementy dekoracyjne
✓Zastosować dobre praktyki projektowania maili poprawiające czytelność

Kiedy używać: Gdy Twój projekt to szkic albo gdy chcesz, żeby AI nadało mailowi profesjonalny szlif.

Kiedy unikać: Jeśli HTML ma jak najwierniej odwzorować Twój projekt z Figmy, zostaw tę opcję wyłączoną.

Łączenie funkcji

Możesz używać Translate i Improve Layout jednocześnie. Na przykład przetłumacz maila na hiszpański i pozwól AI dopracować projekt — wszystko w jednym generowaniu.

Podgląd wyniku

Gdy generowanie się zakończy, zobaczysz ekran wyniku, na którym możesz obejrzeć, porównać i wyeksportować HTML maila.

Tryby podglądu

Widok desktopowy

Podgląd maila w szerokości 800px, typowej dla desktopu.

Widok mobilny

Sprawdź responsywność w szerokości 425px — zobacz, jak kolumny układają się jedna pod drugą, a tekst się przelewa.

Tryb jasny

Standardowy jasny podgląd — tak zobaczy Twojego maila większość odbiorców.

Tryb ciemny

Przybliżony podgląd trybu ciemnego: inwersja kolorów w stylu Gmaila, która pokazuje, czy tekst i obrazy pozostają czytelne. Każdy klient pocztowy stosuje własne reguły trybu ciemnego, więc efekty mogą się różnić.

Porównanie wizualne

Pod podglądem znajdziesz porównanie obok siebie, w którym zestawisz wygenerowany HTML z oryginalnym projektem w Figmie.

✓Przesuwaj kursor na boki — linia podziału podąża za nim i odsłania więcej projektu albo HTML
✓Przesuwaj kursor w pionie, żeby przewijać długie maile
✓Etykiety w górnych rogach pokazują, która strona to projekt, a która HTML

Opcje eksportu

Na dole ekranu wyniku znajdziesz cztery akcje:

Kopiuj kod

Kopiuje cały HTML do schowka. Wklej go prosto do edytora kodu w swoim ESP.

Pobierz HTML

Pobiera jeden plik .html. Obrazy są podlinkowane z CDN FigMail.

Pobierz archiwum

Pobiera plik ZIP z HTML i wszystkimi obrazami. Przydaje się, jeśli chcesz hostować obrazy na własnym serwerze.

Otwórz w edytorze Blocks

Otwiera maila w Blocks — wizualnym edytorze maili — żebyś mógł dalej go tam edytować.

Wskazówka: Naciśnij ESC, żeby wrócić do panelu historii i zobaczyć pozostałe generowania.

Historia generowań

FigMail przechowuje historię Twoich generowań, więc możesz wrócić do wcześniejszego maila i wyeksportować go ponownie.

Jak otworzyć historię

Kliknij ikonę zegara w nagłówku wtyczki, żeby otworzyć panel historii. Wysuwa się z prawej strony i pokazuje Twoje wcześniejsze generowania.

Miniatury podglądu

Każdy wpis pokazuje miniaturę oryginalnego projektu z Figmy, więc szybko go rozpoznasz.

Nazwy ramek

Wyświetlana jest nazwa ramki z Figmy, co ułatwia znalezienie konkretnego maila.

Znaczniki czasu

Sprawdź, kiedy powstało każde generowanie — dzisiejsze wpisy pokazują tylko godzinę, starsze pełną datę.

Nieskończone przewijanie

Przewiń w dół, żeby zobaczyć więcej — starsze generowania wczytują się automatycznie, gdy dojdziesz do końca listy.

Wskaźniki statusu

Każde generowanie ma plakietkę z aktualnym statusem:

CompletedGenerowanie zakończone — kliknij, żeby obejrzeć i wyeksportować
Processing 45%Generowanie w toku — kliknij, żeby śledzić postęp na żywo
QueuedCzeka w kolejce — przetwarzanie wkrótce się zacznie
FailedPodczas generowania wystąpił błąd — spróbuj wygenerować ponownie

Wznawianie trwających generowań

Jeśli zamkniesz wtyczkę w trakcie generowania, nic się nie stanie. Otwórz ją ponownie i kliknij przetwarzany wpis w historii, żeby dalej śledzić postęp. Generowanie trwa na serwerze niezależnie od tego, czy wtyczka jest otwarta.

Kod i eksport

FigMail generuje czysty, dobrze ustrukturyzowany HTML zgodny z dobrymi praktykami kodowania maili. Kod jest czytelny, łatwy w utrzymaniu i prosty do rozbudowy.

Przejrzysta struktura

Logiczne zagnieżdżanie tabel z czytelną hierarchią.

Style inline

Podstawowe style są przypisane do każdego elementu, więc mail trzyma się w klientach, które usuwają CSS.

Bezpieczny dla Outlooka

Komentarze warunkowe MSO, ghost tables i fallbacki bgcolor dla Outlooka.

Gotowy na mobile

Media queries układają kolumny jedna pod drugą na małych ekranach.

output.html
Loading...

Struktura kodu

✓

Układ tabelaryczny

Zagnieżdżone tabele dla zgodności z Outlookiem

✓

CSS inline

Podstawowe style przypisane bezpośrednio do elementów

✓

Fallbacki dla Outlooka

Komentarze warunkowe, ghost tables i jednolite kolory zastępcze dla gradientów

✓

Media queries

Responsywne breakpointy w osadzonych stylach

Integracja z ESP

Wygenerowany HTML to standardowy HTML email, więc użyjesz go z dowolnym dostawcą usług mailingowych. Oto jak:

Mailchimp

Wklej go do edytora kodu w opcji „Edit with HTML”

Klaviyo

Zaimportuj go przez Templates → Create from HTML

SendGrid

Użyj go w Dynamic Templates lub Marketing Campaigns

Dowolne inne ESP

Wklej lub zaimportuj HTML wszędzie tam, gdzie można użyć własnego kodu

Dostosowywanie

Merge tagi

Zastąp tekst zastępczy składnią personalizacji swojego ESP:

{{first_name}}*|FNAME|*${contact.firstName}

Piksele śledzące

Dodaj piksel analityczny przed zamykającym tagiem </body>. Większość ESP dodaje go automatycznie.

Logika warunkowa

Opakuj sekcje składnią warunkową swojego ESP, żeby pokazywać lub ukrywać treści na podstawie danych subskrybenta.

Co zawiera eksport

ElementOpis
ObrazyEksportowane w 2x i hostowane na CDN FigMail. Pobierz archiwum, jeśli chcesz hostować je samodzielnie.
Fonty weboweGoogle Fonts są podlinkowane w nagłówku dokumentu, z fontami zastępczymi web-safe dla klientów, które je ignorują, takich jak Outlook.
PreheaderUkryty tekst podglądu, który skrzynki pokazują obok tematu.

Rozwiązywanie problemów

Dlaczego wynik może się różnić od projektu?

Klienty pocztowe obsługują znacznie mniej CSS niż przeglądarki. Niektórych efektów z Figmy (cienie, rozmycie, tryby mieszania) nie da się odtworzyć 1:1 w HTML email.

Do tego FigMail generuje kod za pomocą silnika AI. Różnice mogą wynikać z:

  • Złożonej struktury układu: głęboko zagnieżdżonych ramek lub niejednoznacznego pozycjonowania.
  • Zaleceń projektowych: nieprzestrzegania dobrych praktyk.
  • Interpretacji AI: sporadycznych błędów przetwarzania lub „halucynacji” modelu.

Jeśli trafisz na poważne problemy, spróbuj uprościć strukturę układu (użyj Auto Layout) albo wróć do poradnika dla projektantów powyżej.

Obrazy się nie wyświetlają?

Upewnij się, że obrazy są wewnątrz zaznaczonej ramki. Jeśli hostujesz obrazy samodzielnie, sprawdź, czy ich adresy URL są publicznie dostępne.

Układ rozjeżdża się w Outlooku?

Outlook dla Windows korzysta z silnika renderującego Worda. Unikaj nakładających się warstw i ujemnych marginesów i trzymaj się prostego Auto Layout. Zaokrąglone rogi przycisków w Outlooku są kwadratowe.

Tekst wygląda inaczej?

Klienty pocztowe często nadpisują style fontów, a wiele z nich ignoruje fonty webowe. FigMail zawsze dodaje font zastępczy web-safe (np. Arial lub Helvetica), więc tekst pozostaje czytelny, gdy własny font się nie wczyta.

Gotowy na lepsze maile?

Projektuj w Figmie, generuj z FigMail HTML gotowy do wysyłki i wysyłaj go z platformy mailingowej, której już używasz.