Символьная ссылка HTML — запись в исходнике, которую парсер разрешает в символы. EntityCodec работает с ограниченным текстом и не утверждает, что разбирает целый документ.
Три видимые формы
Ссылка может использовать имя &, десятичную точку & или hex &. Все три представляют амперсанд, но отличаются читаемостью.
Кодирование бывает многослойным
Текст © после одного прохода становится ©, и только второй даёт ©. EntityCodec намеренно делает один проход.
Проверьте точное место использования
Кодирование символьных ссылок меняет представление текста, а не уровень доверия к данным. Оставляйте результат текстом, пока целевая система не применит правильное для контекста экранирование или санитизацию. После вставки сравните результат полностью. Для воспроизводимой проверки храните один буквальный пример рядом с ожидаемой кодированной формой, дважды выполните один и тот же профиль и сверьте каждый амперсанд, точку с запятой, кодовую точку, пробел и перенос. Затем проверьте текстовую привязку целевой системы на безвредных характерных символах. Если система нормализует, повторно декодирует или рендерит значение, документируйте это отдельно: такое поведение уже находится за границей EntityCodec.