§Как пользоваться

  1. Выберите вкладку: Base64, URL, HTML или Изображение.
  2. Введите текст в левое поле, код появится справа. Работает и в обратную сторону: вставьте Base64, %D0%BF… или «…» в правое поле, и расшифровка появится слева.
  3. Под правым полем выберите вариант: URL-safe Base64, режим URL-кодирования, какие символы превращать в мнемоники и в каком виде. Для текстов со старых русских сайтов слева есть кодировка Windows-1251.
  4. Во вкладке «Изображение» перетащите файл, выберите вид кода (data URI, чистый Base64, CSS или тег <img>) и скопируйте его. Чтобы достать картинку из Base64, вставьте код в правое поле: появится предпросмотр и кнопка «Скачать файл».

Всё считается в браузере, текст и файлы никуда не отправляются. Если строка не декодируется, под полем написано, какой символ мешает и в какой позиции.

§Base64: как устроен и почему он длиннее

Base64 описан в RFC 4648. Каждые 3 байта он записывает 4 символами из алфавита A–Z a–z 0–9 + /, поэтому результат всегда примерно на треть длиннее исходных данных. Если байтов не кратно трём, в конце ставится один или два знака =. Почтовый стандарт MIME (RFC 2045) вдобавок требует разбивать Base64 на строки не длиннее 76 символов. Для этого есть переключатель «Строки по 76 символов».

Base64 переводит байты, а не буквы. Поэтому слово «Привет» сначала превращается в 12 байтов UTF-8 и только потом в 0J/RgNC40LLQtdGC. Встроенная функция btoa("Привет") в JavaScript выдаёт ошибку InvalidCharacterError, потому что принимает только латиницу. Здесь кириллица и эмодзи кодируются правильно. В кодировке Windows-1251 то же слово занимает 6 байтов и выглядит как z/Do4uXy.

URL-safe вариант (base64url) заменяет + на -, / на _ и убирает =, чтобы строку можно было вставить в адрес. Он используется в JWT и в ключах Web Push, подробнее в статье о Web Push без Firebase. Декодер здесь понимает оба алфавита, пробелы, переносы строк и отсутствующие =.

Где встречаетсяПример
Basic-авторизация в HTTPAuthorization: Basic dXNlcjpwYXNz (это user:pass)
Картинка внутри CSS или HTMLdata:image/png;base64,iVBORw0KGgo…
Вложения в письмахContent-Transfer-Encoding: base64
JWT-токеныeyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIn0.…

Base64 не шифрует данные: любой раскодирует строку за секунду. Пароли и ключи в нём хранятся так же открыто, как в обычном тексте.

§URL-кодирование: какой режим выбрать

В адресе разрешены только латиница, цифры и несколько знаков. Всё остальное, в том числе кириллица и пробел, записывается байтами в виде %XX (RFC 3986). Буква кириллицы в UTF-8 занимает 2 байта, поэтому «привет» превращается в %D0%BF%D1%80%D0%B8%D0%B2%D0%B5%D1%82, то есть в 36 символов вместо 6. Главное различие режимов в том, какие служебные знаки адреса остаются как есть.

РежимНе кодируетПробелАналогКогда нужен
ПараметрA–Z a–z 0–9 - _ . ! ~ * ' ( )%20encodeURIComponent() в JSзначение параметра или часть пути, где &, = и / должны стать кодами
Адресто же плюс ; , / ? : @ & = + $ #%20encodeURI() в JSадрес целиком, когда в нём кириллица, а структуру нужно сохранить
ФормаA–Z a–z 0–9 - _ . *+URLSearchParams в JS, urlencode() в PHPтело POST-формы и строка запроса, собранная из формы (спецификация)

Если адрес раскодировался в набор странных символов или с ошибкой UTF-8, скорее всего его собрал старый сайт в Windows-1251: там «привет» выглядит как %EF%F0%E8%E2%E5%F2. Переключите кодировку слева. Для новых адресов кириллицу лучше заменить транслитом, это делает генератор ЧПУ.

Одиночный знак % без двух шестнадцатеричных цифр после него ломает декодирование. В JavaScript это ошибка URIError: URI malformed, а здесь вы увидите позицию проблемного знака. Сам процент кодируется как %25.

§HTML-мнемоники и числовые коды

Пять символов в HTML служебные, и в тексте их нужно заменять ссылками на символы (спецификация HTML). У каждого символа есть числовой код в десятичном (&#38;) или шестнадцатеричном (&#x26;) виде, а у части символов есть ещё и имя (&amp;).

СимволМнемоникаДесятичный кодШестнадцатеричныйКогда обязателен
&&amp;&#38;&#x26;в тексте и в атрибутах, в том числе в ссылках: ?a=1&amp;b=2
<&lt;&#60;&#x3C;в тексте, чтобы браузер не принял его за начало тега
>&gt;&#62;&#x3E;строго не обязателен, но принято заменять парой к <
"&quot;&#34;&#x22;в атрибутах в двойных кавычках
'&apos;&#39;&#x27;в атрибутах в одинарных кавычках. &apos; нет в HTML 4, поэтому кодировщик пишет &#39;

Если страница в UTF-8, кириллицу и типографские знаки кодировать не нужно. Режим «+ не ASCII» пригодится для писем, старых CMS и систем, которые принимают только латиницу. Тогда «ёлочки» станут &laquo; и &raquo;, тире станет &mdash;, знак номера &numero;. У знака тенге ₸ имени нет, только код &#8376;. Режим «Всё» превращает в коды каждый символ: так иногда прячут e-mail от простых сборщиков адресов.

Коды от &#128; до &#159; браузер по историческим причинам читает как символы Windows-1252: &#150; показывает короткое тире, а не управляющий символ. Декодер повторяет это поведение. Мнемоники он понимает все, которые знает браузер, а не только популярные.

§Картинка в Base64: когда это выгодно

Картинка в виде текста записывается как data URI (RFC 2397): data:<тип>;base64,<данные>. Такую строку можно вставить в src или в CSS-свойство background-image, и браузер не будет делать за картинкой отдельный запрос. Цена такая:

  • Base64 на треть тяжелее файла, а PNG, JPEG и WebP уже сжаты, поэтому gzip почти ничего не возвращает;
  • картинка кешируется вместе с CSS или HTML и скачивается заново при каждом их изменении;
  • большой data URI в CSS задерживает отрисовку страницы, пока стили не загрузятся целиком;
  • Gmail и многие другие почтовые клиенты не показывают картинки в data URI, поэтому для подписи в письме этот способ не подходит.

Встраивать имеет смысл маленькие иконки и фоны до нескольких килобайт. SVG выгоднее вставлять без Base64, с URL-кодированием: строка короче и читается. Для этого есть инструмент SVG в CSS, а почему так лучше, разобрано в статье про SVG в вёрстке.

Если в правое поле вставить Base64 без заголовка data:, тип файла определяется по первым байтам. Их же можно узнать по началу строки:

Начало Base64Формат
iVBORw0KGgoPNG
/9j/JPEG
R0lGODGIF
UklGRWebP (и другие файлы RIFF)
PHN2Zy или PD94bWwgSVG (<svg или <?xml)
JVBERi0PDF