View source for Quoted-printable

{{short description |Escape syntax for representing binary data}}
{{More citations needed |date=January 2021}}

The '''Quoted-Printable''' encoding is an [[Escape sequence|escape syntax]] that uses [[graphic character|printable ASCII characters]] ([[alphanumeric]] and the [[equals sign]] <code>=</code>) to represent arbitrary [[binary data]] to enable transmission of [[octet (computing)|8-bit]] data over a 7-bit data path or, generally, over a medium which is not [[8-bit clean]]. Historically, because of the wide range of systems and protocols that could be used to transfer messages, e-mail was often assumed to be non-8-bit-clean{{snd}}however, modern [[SMTP]] servers ''are'' in most cases 8-bit clean and support the <code>8BITMIME</code> extension. It can also be used with data that contains non-permitted [[octet (computing)|octets]] or line lengths exceeding SMTP limits. It is defined as a MIME [[MIME#Content-Transfer-Encoding|content transfer encoding]] for use in [[e-mail]].

The Quoted-Printable encoding works by using the equals sign <code>=</code> as an [[escape character]]. It also limits line length to 76, as some software has limits on line length.

== Introduction ==
{{Unreferenced section|date=October 2025}}
[[MIME]] defines mechanisms for sending other kinds of information in e-mail, including text in languages other than [[English language|English]], using [[character encoding]]s other than ASCII. However, these encodings often use byte values outside the ASCII range so they need to be encoded further before they are suitable for use in a non-8-bit-clean environment. The Quoted-Printable encoding is one method used for mapping arbitrary bytes into sequences of ASCII characters. So, Quoted-Printable is not a character encoding scheme itself, but a data coding layer to be used under some [[byte-oriented]] character encoding. The Quoted-Printable encoding is reversible, meaning the original bytes and hence the non-ASCII characters they represent can be identically recovered.

Quoted-Printable and [[Base64]] are the two MIME content transfer encodings, if the trivial "7bit" and "8bit" encoding are not counted. If the text to be encoded does not contain many non-ASCII characters, then Quoted-Printable results in a fairly readable{{efn|This implies that an ASCII compatible encoding is used. A Quoted-Printable-encoded text in e.g. [[EBCDIC]] would not be readable of course.}} and compact encoded result. On the other hand, if the input has many 8-bit characters, then Quoted-Printable becomes both unreadable and extremely inefficient. Base64 is not human-readable, but has a uniform overhead for all data and is the more sensible choice for binary formats or text in a [[Script (Unicode)|script]] other than the [[Latin script]].

== Encoding <span class="anchor" id="Quoted-printable encoding"></span> ==
Any 8-bit byte value may be encoded with 3 characters: an <code>=</code> followed by two [[hexadecimal]] digits (0–9 or A–F) representing the byte's numeric value. For example, an ASCII [[form feed]] character (decimal value 12) can be represented by <code>=0C</code>, and an ASCII equal sign (decimal value 61) must be represented by <code>=3D</code>. All characters except printable ASCII characters or [[newline|end of line characters]] (but also <code>=</code>) must be encoded in this fashion.

All printable ASCII characters (decimal values between 33 and 126) may be represented by themselves, except <code>=</code> (decimal 61, hexadecimal 3D, therefore <code>=3D</code>).

ASCII [[horizontal tabulation|tab]] and [[space character]]s, decimal values 9 and 32, may be represented by themselves, except if these characters would appear at the end of the encoded line. In that case, they would need to be escaped as <code>=09</code> (tab) or <code>=20</code> (space), or be followed by a <code>=</code> (soft line break) as the last character of the encoded line. This last solution is valid because it prevents the tab or space from being the last character of the encoded line.

If the data being encoded contains meaningful line breaks, they must be encoded as an ASCII CR LF sequence, not as their original byte values, neither directly nor via <code>=</code> signs. Conversely, if byte values 13 and 10 have meanings other than end of line (in media types,<ref>Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies. November 1996. [https://tools.ietf.org/html/rfc2045#section-6.7 RFC 2045 # 6.7 Quoted-Printable Content-Transfer-Encoding], part "(4) (Line Breaks)". Retrieved March 18, 2013.</ref> for example), then they must be encoded as <code>=0D</code> and <code>=0A</code> respectively.

Lines of Quoted-Printable encoded data must not be longer than 76 characters. To satisfy this requirement without altering the encoded text, ''soft line breaks'' may be added as desired. A soft line break consists of an <code>=</code> at the end of an encoded line, and does not appear as a line break in the decoded text. These soft line breaks also allow encoding text without line breaks (or containing very long lines) for an environment where line size is limited, such as the 1000 characters per line limit of some [[SMTP]] software, as allowed by RFC 2821.

A slightly modified version of Quoted-Printable is used in message headers. {{xref|(See also {{slink|MIME#Encoded-Word}}.)}}

== Example ==
The following example is a French text (encoded in UTF-8), with a high frequency of letters with diacritical marks (such as the ''é'').
 J'interdis aux marchands de vanter trop leurs marchandises. Car ils se font=
  vite p=C3=A9dagogues et t'enseignent comme but ce qui n'est par essence qu=
 'un moyen, et te trompant ainsi sur la route =C3=A0 suivre les voil=C3=A0 b=
 ient=C3=B4t qui te d=C3=A9gradent, car si leur musique est vulgaire ils te =
 fabriquent pour te la vendre une =C3=A2me vulgaire.
 
    =E2=80=94=E2=80=89Antoine de Saint-Exup=C3=A9ry, Citadelle (1948)

This encodes the following quotation:
{{quote
|text= J'interdis aux marchands de vanter trop leurs marchandises. Car ils se font vite pédagogues et t'enseignent comme but ce qui n'est par essence qu'un moyen, et te trompant ainsi sur la route à suivre les voilà bientôt qui te dégradent, car si leur musique est vulgaire ils te fabriquent pour te la vendre une âme vulgaire.
|author= [[Antoine de Saint-Exupéry]]
|source= ''Citadelle'' (1948)
}}

== See also ==
* [[Percent-encoding]]{{snd}}data encoding in URLs, mostly used for text
* [[Numeric character reference]]{{snd}}text encoding in SGML, HTML, and XML
* {{slink|Rich Text Format#Character encoding}}{{snd}}a component of text encoding

== Notes ==
{{notelist}}

== References ==
<references/>

== External links ==
* {{IETF RFC|1521}} (obsolete)
* {{IETF RFC|2045}} (MIME)
** [https://tools.ietf.org/html/rfc2045#section-6.7 RFC 2045 — 6.7. Quoted-Printable Content-Transfer-Encoding]

[[Category:Email]]