Dispelling Myths About Markup Formats: When What Why Where

Liam Quin

Owner and coffee-slave
Delightful Computing

Abstract

Misunderstandings about the goals and strengths of different document and data interchange formats can lead to suboptimal decisions. Such misunderstandings appear widespread. The purpose of this paper is to suggest areas in which each format has strengths, and to provide clear explanations that people can use to place XML in the context of other current markup systems.

Common misconceptions about XML include statements such as “XML was designed for Web services and therefore unsuitable for documents;” “XML was designed to replace HTML and has failed;” “XML cannot transmit semantics of any kind;” “XML is dead.” In fact, XML is alive and well. There are misconceptions about other formats, too, of course.


Table of Contents

Introduction
HTML: The HyperText Markup Language (HTML).
Markdown
RDF and Linked Data
JavaScript Object Notation (JSON)
JSON-LD: JSON meets RDF
Portable Document Format (PDF)
Domain-specific XML Vocabularies
XHTML™: The Extensible HyperText Markup Language
DocBook
Customizing DocBook: Mallard
The Text Encoding Initiative (TEI)
Open Document Format (ODF), OOXML
Raster Images
Conclusion
Bibliography