SupperTools

Useful Online Tools & Utilities to Make Everyday Tasks Easier.

Quoted Printable Decoder to Convert QP Text Back to Plain Text

Decode quoted printable text from raw emails and files back into readable plain text, resolving =XX escapes and soft line breaks in a single click.

Open a raw email message and sooner or later you meet text like Caf=C3=A9 or a sentence that ends abruptly with an equals sign and continues on the next line. That is quoted printable, a MIME encoding used to move non ASCII text through old email systems, and it makes messages unreadable until decoded. The Decode Quoted Printable tool reverses the encoding in one step, turning =XX sequences and wrapped lines back into the plain text the sender actually wrote.

Where Quoted Printable Text Comes From

Email was designed for plain ASCII, but people write in accented characters, currency symbols and dozens of alphabets. Quoted printable, defined as part of the MIME standards in RFC 2045, solves this by leaving ordinary printable characters alone and escaping everything else as an equals sign followed by two hexadecimal digits representing the byte. An é in UTF-8 is the two bytes C3 A9, so it appears as =C3=A9. Lines are also kept short by inserting soft breaks: an equals sign at the very end of a line, which means "join the next line on" rather than a real equals.

You meet the encoded form when viewing raw message source, debugging mail servers, reading .eml files in a text editor, migrating old mailboxes, or handling data exported from systems that stored the encoded body instead of the decoded one.

What the Quoted Printable Decoder Does

  • Converts every =XX escape back into its character, reconstructing accented letters, symbols and non Latin text from their byte values.
  • Joins soft broken lines correctly, removing the trailing equals signs that were only there to wrap long lines.
  • Handles the awkward corners: a literal equals sign stored as =3D, and trailing spaces or tabs protected as =20 and =09 so they survive the journey.
  • Runs as a single action: paste the encoded text in the box at the top and click Decode.

Need the reverse journey, turning readable text into this encoded form for testing or mail system work? The Encode Quoted Printable tool does it, and the Base64 to Text decoder handles the other encoding email commonly uses.

How to Decode Quoted Printable Text

  1. Copy the encoded text exactly as it appears in the raw message or file, including any lines that end in an equals sign.
  2. Paste it into the box at the top of the Decode Quoted Printable tool.
  3. Check you have not trimmed the beginning or end; a cut off =XX sequence at either edge will decode incorrectly.
  4. Click Decode to convert the text.
  5. Read the plain text result: accents, symbols and paragraph structure should now look the way the sender wrote them.
  6. Copy the decoded text wherever it is needed, and if parts still look garbled, check whether the original used a character set other than UTF-8.

Worked Example: Reading an Encoded Email Fragment

Suppose a raw message body contains this line: Merci pour le caf=C3=A9 =E2=82=AC4,50 =C3=A0 Paris, followed by a line ending in a lone equals sign and then the word "demain". Decoding works through it piece by piece: =C3=A9 becomes é, =E2=82=AC becomes the euro sign, and =C3=A0 becomes à. The trailing equals is a soft break, so the next line joins seamlessly. The readable result is: "Merci pour le café €4,50 à Paris demain", a perfectly ordinary sentence that was simply wearing its transport encoding.

Notice that the readable characters, the letters, spaces and punctuation, were never encoded at all. That is the design of quoted printable: mostly readable text with escapes only where the character set demands them.

Tips for Clean Decoding and Common Pitfalls

Preserve the raw text faithfully. The commonest cause of bad output is pasting through something that "helpfully" altered the content first, such as a rich text editor that converted characters or a spreadsheet that split lines. Paste from the raw source, ideally via a plain text editor.

Mind the character set. Quoted printable escapes bytes, not characters, so the bytes only become the right characters when interpreted in the message's declared charset. Most modern mail is UTF-8; older Western European mail may be ISO-8859-1, where =E9 alone is é. If decoded text shows odd pairs of characters, a charset mismatch is the likely story.

Do not confuse it with header encoding. Email subject lines use a related but distinct scheme, encoded words like =?UTF-8?Q?...?=, where underscores stand for spaces. That Q encoding is not identical to body quoted printable, and body rules should not be applied to headers.

One equals sign is data, the other is wrapping. An equals followed by two hex digits is a byte; an equals at the very end of a line is a soft break. Losing track of which is which, especially when lines were re wrapped by another program, produces most remaining garbling.

Frequently Asked Questions About Quoted Printable Decoding

What does the =XX pattern mean?

An equals sign followed by two hexadecimal digits represents a single byte of the original text. =C3=A9, for example, is the two UTF-8 bytes for é, and =3D is an equals sign itself.

Why do some lines end with an equals sign?

That is a soft line break. Quoted printable limits line length, so long lines are wrapped with a trailing equals that decoders remove, joining the text back into one continuous line.

Is quoted printable the same as Base64?

No. They are two different MIME transfer encodings. Base64 re encodes everything into a compact alphabet, while quoted printable leaves readable ASCII untouched and only escapes the characters that need it.

Why does my decoded text still show strange characters?

Usually a character set mismatch: the bytes were decoded as UTF-8 when the message was written in another charset, or vice versa. Check the charset declared in the original message headers.

Can I decode a whole .eml file with this tool?

You can paste the encoded body sections of the file and decode those. Headers and attachments use their own encodings, so handle the message body as text and attachments separately.

Does decoding change the formatting of the message?

It restores the text as written, including line breaks that were real. Only the artificial soft breaks added for transport are removed.

Make Encoded Email Text Readable Again

Quoted printable is a transport costume, not the message itself. The decoder strips that costume away in one click, so raw email source, exported mail data and stubborn .eml files become text you can actually read, search and quote.

Related Tools