- A root element is always added
- XML permits exactly one top-level element, so the YAML document is wrapped, by default in <root>. Sequence entries additionally need element names, since XML has no anonymous list; each becomes <item> unless renamed.
- Keys that are not valid XML names are rewritten
- An XML element name must begin with a letter or underscore and cannot contain spaces. A key like "2024" becomes <_2024> and "first name" becomes <first_name>. The rewrite is reported and is not reversible, so converting back will not restore the original key text.
- null becomes an empty element
- YAML null has no XML counterpart, so it is written as an empty element, which is indistinguishable from an empty string. Schemas that need real nullability use xsi:nil, which this converter does not add automatically.
- Comments and anchors are lost
- YAML comments are dropped, and anchors and aliases are expanded into full copies before serialisation. The data is correct but repeated, and the shared relationship is no longer visible.