Если получатель видит теги вроде <p> и <a>, сначала изучите MIME-структуру принятого сообщения. Возможно, HTML записали в часть text/plain или превратили разметку в обычный текст ещё при сборке. Правка CSS не исправит неверный тип содержимого. Сохраните синтетическое письмо в исходном виде и сравните его с результатом перед отправкой.

Другой случай — клиент намеренно показывает текстовую альтернативу. Тогда теги могут отсутствовать, но оформление всё равно не видно. Разделите эти симптомы: одно требует ремонта сборщика сообщения, другое — проверки выбранной части и настроек клиента. Проверка проводится на письме, дошедшем до ящика, а не только на HTML-превью в панели сайта.

Нарисуйте дерево частей принятого сообщения

Условная структура, не готовый .eml:
multipart/alternative
  text/plain; charset=UTF-8 -> осмысленный текст
  text/html; charset=UTF-8  -> HTML с тем же действием
вложения при наличии -> отдельная корректная MIME-структура
Content-Transfer-Encoding -> задаёт библиотека
проверка -> распарсить принятое письмо и сравнить обе части

RFC 2046 определяет multipart/alternative как альтернативные представления одного содержания и описывает порядок предпочтения частей. Источник проверен 21 октября 2026 года. Для обычной пары простой текст располагают перед более насыщенным HTML. Это не требование показывать оформление вопреки настройкам пользователя и не гарантия одинакового вида во всех клиентах.

Симптом подсказывает слой проверки

Что видноКуда смотреть
Буквальные теги в телеНе попал ли HTML в text/plain
Символы &lt; и &gt; в разметкеГде HTML экранировали как данные
Только связный текст без оформленияВыбранная альтернатива и режим клиента
Пустое тело или границы частейСборка MIME и парсинг сообщения
HTML распознан, стили отличаютсяОтдельная проверка совместимости вёрстки

Не исправляйте проблему безусловным отключением экранирования во всём шаблоне. Пользовательские значения должны оставаться данными. Разделите доверенную разметку письма и имя, комментарий или другой внешний текст. Если сборщик ожидает HTML-часть, передавайте её соответствующим методом библиотеки, не подменяя вручную случайный заголовок общего сообщения.

Текстовую альтернативу нельзя оставлять старой после правки HTML. У обеих частей должны совпадать назначение письма, ссылка действия и существенные условия. Пользователь, выбравший plain text, должен получить рабочее уведомление. Простое удаление тегов из сложного макета может склеить слова и убрать адрес кнопки; результат читают отдельно.

Контрольный набор проверяет сборку, а не красоту

  1. Собрать письмо с коротким текстом, ссылкой и кириллицей.
  2. Распарсить MIME и проверить типы обеих частей.
  3. Добавить кавычки и угловые скобки в синтетическое имя.
  4. Повторить с вложением, если продукт его поддерживает.
  5. Открыть принятое письмо в HTML- и текстовом режиме.

Сырой .eml может содержать адреса, ссылки с токенами и другие приватные сведения. Для общего разбора используйте синтетический экземпляр или тщательно обезличенную копию. Не отправляйте рабочие токены подтверждения в сторонний сервис проверки вёрстки. Тестовая отправка должна идти только на контролируемые адреса.

После ремонта сохраните регрессионный тест структуры для используемой версии почтовой библиотеки. Откат возвращает прежний сборщик для новых сообщений, но уже доставленные письма не меняет. Для диагностики подготовьте дерево MIME и по одному обезличенному фрагменту каждой части: этого достаточно, чтобы отделить ошибку формата от задачи совместимости HTML.

Проверенные источники