What XML is
XML marks up data with nested named tags and optional attributes. It is verbose, strict about being well-formed, and can carry a schema that says what shape a document must have.
Enterprise integrations, government data feeds, RSS, SOAP services and older document formats.
What Markdown is
A Markdown table is rows of pipe-separated cells with a dashed rule under the header. Alignment is set by placing colons in that rule.
README files, GitHub issues, documentation sites, Obsidian and Notion.
What changes when you convert XML to Markdown
The first repeating element is treated as the rows. Attributes are read alongside child elements and prefixed so they do not collide with a same-named tag. Nesting one level deep becomes dotted column names; deeper structures are kept as text.
Cells are padded so the source lines up in a plain text editor, pipes inside values are escaped, and line breaks inside a cell become <br> because a Markdown table row cannot span lines.
What carries over from XML to Markdown
XML records 3 things about a table that Markdown has no way to hold.
An empty cell and a missing one are the same thing in Markdown, so a null and an empty string in the XML both come out blank and can no longer be told apart.
XML can hold a value that is itself a list or an object. Markdown has only flat cells, so nested values are flattened into one cell rather than being spread across columns.
A line break inside a cell ends the row in Markdown, so line breaks are replaced rather than carried through.
Markdown marks header cells differently from data cells, so the keys are lifted out and written once as a marked header row rather than repeated on every row.
The identifier 007 comes out of the Markdown as 007. Reading it as a number would have made it 7, and an id that changes value is worse than one that stays text.
The role "Analyst, data" survives with its comma, in one cell rather than split across two. That is the first thing to check in any converted table, and the usual place a Markdown file goes wrong.
The quotes around Jonah "Jo" Pryce are left as a plain quote character in the Markdown.