Polyglot markup


In computing, a polyglot markup is a document or script written in a valid form of multiple markup languages, which performs the same output, independent of the markup's parser, layout engine, or interpreter. In general, the polyglot markup is a common subset of two or more languages, that can be used as a robust or simplified profile.
Polyglot HTML is HTML that has been written to conform to both the HTML and XHTML specifications. A polyglot document can therefore be parsed as either HTML or XML, and will produce the same DOM structure either way. For example, in order for an HTML5 document to meet these criteria, the two requirements are that it must have an HTML5 doctype, and be written in well-formed XHTML. The same document can then be served as either HTML or XHTML, depending on browser support and MIME type.

Polyglot HTML requirements

As expressed by the html-polyglot recommendation, to write a polyglot HTML5 document, the following key points should be observed:
  1. Processing instructions and the XML declaration are both forbidden in polyglot markup
  2. Specifying a document’s character encoding
  3. The DOCTYPE
  4. Namespaces
  5. Element syntax
  6. Element content
  7. Text
  8. Attributes
  9. Named entity references
  10. Comments
  11. Scripting and styling polyglot markup
The most basic possible polyglot markup document would therefore look like this:




The title element must not be empty.





In a polyglot markup document non-void elements cannot be self-closing even if they are empty, as this is not valid HTML. For example, to add an empty textarea to a page, one cannot use instead.