Cómo usar el formateador
- Pegue el XML o suelte un archivo .xml, .svg, .rss, .xsd, .kml, .gpx o .config.
- Elija el modo: formatear / embellecer o minificar.
- Ajuste las opciones: sangría, conservar comentarios, atributos en líneas propias.
- Compruebe el estado: «XML bien formado» o el error con su línea.
- Copie o descargue el resultado.
¿Qué significa «bien formado»?
Un documento XML está bien formado cuando cumple las reglas sintácticas básicas. Si se rompe una sola regla, los programas lo rechazan.
| Regla | Correcto | Incorrecto |
|---|---|---|
| Exactamente un elemento raíz | <a><b/></a> | <a/><b/> |
| Cada etiqueta se cierra | <p>texto</p> | <p>texto |
| Anidamiento correcto | <a><b></b></a> | <a><b></a></b> |
| Atributos entre comillas | id="1" | id=1 |
| & y < escapados | & | & suelto |
| Distingue mayúsculas | <Item></Item> | <Item></item> |
El formateador usa el analizador XML de su navegador e indica la línea y la descripción del primer error. Atención: bien formado no significa válido según un esquema. La validación contra un XSD comprueba además qué elementos se permiten, y requiere herramientas específicas.
Formatear y minificar
Al formatear, cada elemento recibe su propia línea con una sangría según su profundidad. Los elementos con texto corto se quedan en una línea, por ejemplo <name>Ana</name>. Las secciones CDATA, las instrucciones de procesamiento y la declaración XML se conservan. Con «Cada atributo en su propia línea», los elementos con muchos atributos, habituales en SVG o archivos de configuración, son más fáciles de leer y comparar en Git. Al minificar, se eliminan los espacios entre elementos y, si quiere, los comentarios, lo que reduce el tamaño para transferencias o almacenamiento.
Estadísticas del documento
Bajo el resultado ve el elemento raíz, el número de elementos, la profundidad máxima de anidamiento y el tamaño antes y después. La lista de elementos más frecuentes ofrece una visión rápida de la estructura de un archivo desconocido, práctico al analizar una exportación o una respuesta de API por primera vez.
Un ejemplo
Recibe una factura electrónica en formato Facturae como una única línea de varios miles de caracteres. Péguela en el formateador: la herramienta confirma «XML bien formado» y muestra la estructura con sus bloques de cabecera, partes y facturas, cada uno bien sangrado. Así encuentra rápidamente el NIF del emisor, el importe total o una línea de detalle concreta. Si el archivo está dañado, por ejemplo por un & sin escapar en un nombre de empresa, el formateador indica la línea exacta del error.
Errores habituales y cómo corregirlos
- Ampersand sin escapar: un
&en un nombre como «Pérez & Hijos» debe escribirse&, o el analizador se detiene. - Contenido antes de la declaración: la línea
<?xml version="1.0"?>debe ser lo primero del archivo; incluso un espacio o una marca BOM mal colocada puede provocar un error. - Etiquetas mal cerradas: al editar a mano es fácil cerrar un elemento en el orden equivocado. El mensaje de error indica la línea donde el analizador se dio cuenta, que puede estar algo después del error real.
- Codificación incorrecta: si la declaración dice UTF-8 pero el archivo se guardó en Windows-1252, las tildes y la ñ aparecen dañadas. Guarde siempre en UTF-8.
- Prefijos de espacio de nombres sin declarar: un elemento como
<fe:Invoice>requiere que el prefijofeesté declarado conxmlns:fe.
Corrija el primer error indicado y vuelva a comprobar: a menudo un único fallo provoca varios mensajes posteriores.
Preguntas frecuentes
¿Se envía mi XML a un servidor?
No. El análisis y el formato se hacen localmente en su navegador.
¿Puedo formatear SVG?
Sí, SVG es XML. La opción de atributos en líneas propias resulta especialmente útil para SVG.
¿La herramienta valida contra un XSD?
No, comprueba si el documento está bien formado, no su validez según un esquema.
¿Se cambia el contenido al formatear?
Solo los espacios entre elementos. Los textos, atributos y secciones CDATA se mantienen.
¿Qué tamaño puede tener el archivo?
Archivos de varios megabytes se procesan sin problema en un navegador actual.