Lesson 02 of 20

6 mins read

XML Syntax & Well-Formedness Rules

In Plain English

Unlike lenient HTML parsers, XML parsers halt immediately on any syntax error. A document that satisfies all XML syntax rules is termed Well-Formed XML. Core rules include closing every tag, case sensitivity, proper nesting, and quoted attribute values.

The Mental Model

"HTML is like conversational English where minor slang and missing punctuation are forgiven. XML is strict mathematical grammar: omit a single closing bracket and the entire equation is rejected."

Deep Dive: How It Works

Case Sensitivity: <Message>, <message>, and <MESSAGE> are three completely distinct tags.

Strict Nesting: Elements must close in reverse order of opening: text is valid, but text is an error.

Quoted Attributes: All attribute values must be enclosed in quotes: <item qty="5">.

Self-Closing Tags: Empty elements must end with a forward slash: <img src="logo.png" />.

Syntax Blueprint

<parent><child attr="val">Content</child></parent>

All open tags must close, attributes must use quotes, and tags must nest cleanly.

Core Rules to Remember

Zero Tolerance: XML parsers stop on the very first syntax error without guessing.

Case Sensitive: <Title> cannot be closed by </title>.

Entity References: Use < for <, > for >, & for &, " for ", ' for '.

Common Beginner Traps & How to Fix Them

Mistake:Using unescaped ampersands (&) or angle brackets (<) in text.

Why it happens: Writing <title>AT&T</title> breaks XML parsing because & indicates an entity reference.

How to fix: Replace & with & (e.g. <title>AT&T</title>) or wrap in a CDATA section.

Pro Tip: Always run your XML files through an XML validator or DOMParser to guarantee well-formedness before transmission.

Live Interactive Example

Hit Run Code to see it live

Valid Entity References in XML

XML 1.0 / XSD

Live Browser Preview

Click "Preview / Apply" to view the rendered output.

How it works: Demonstrates entity escaping (&, >) and the self-closing <checkpoint /> tag.

Your Turn: Micro Challenge

No pressure! Edit the starter code below and test your solution with instant feedback.

Micro Exercise

Fix unescaped entity references

Given a note with comparison text, replace `<` with `<` and `&` with `&`.
Output: <condition>Score < 50 & Status Pending</condition>

Sandbox Output

Click "Run & Check" to test your solution.

Finished reading and practicing?

Mark this lesson as completed to update your course progress.