Formateador de XML
Da formato a XML con una indentación legible y conserva elementos, atributos, texto, comentarios y entidades escapadas.
Haz que la estructura XML sea más fácil de leer
El XML compacto puede ser eficiente para transmitir, pero es difícil de inspeccionar. Un elemento, atributo, etiqueta de cierre o carácter escapado puede quedar oculto cuando todo está en una sola línea. Este formateador muestra una distribución legible para revisar la estructura antes de usarla en un build, una solicitud o una configuración.
El formato cambia la presentación, no los datos XML previstos. Debe conservar nombres de elementos, valores de atributos, nodos de texto, comentarios y referencias de entidades mientras añade indentación y saltos de línea coherentes. El resultado legible facilita la revisión, pero no es una validación de esquema.
Usa una muestra pequeña y representativa al aprender la herramienta. Conserva por separado el documento original, la copia formateada y cualquier resultado de validación posterior para distinguir sintaxis XML, esquema, codificación y reglas de la aplicación.
Si el documento contiene secretos o datos personales, crea una copia redactada antes de pegarlo. Formatear no anonimiza los datos ni demuestra que compartirlos con otro servicio esté permitido.
Formatear no es validar
XML es un formato de marcado anidado con elementos, atributos, texto, comentarios, declaraciones y referencias de caracteres. Los elementos necesitan etiquetas iniciales y finales coincidentes, los atributos pertenecen a una etiqueta inicial y los caracteres reservados como ampersand deben escaparse cuando son datos.
El formateador interpreta suficiente estructura para ordenar nodos y espacios. No demuestra que el documento coincida con un XSD, DTD, política de namespaces, contrato de aplicación o regla de negocio. Mantén esas comprobaciones en el flujo que las define.
Los espacios pueden ser datos en algunos contextos XML, incluido el contenido mixto y los nodos de texto. Antes de cambiar un documento usado por un consumidor sensible a espacios, compara el resultado con sus requisitos y conserva la fuente original.
Cómo formatear XML
- Pega un documento XML completo o un fragmento documentado en el campo de origen. Elimina prosa no relacionada o un envoltorio de lenguaje de programación de la copia de prueba.
- Ejecuta el formateador e inspecciona el anidamiento, atributos, comentarios y textos. Un fallo de formato es motivo para revisar el origen, no una prueba de un mensaje concreto del parser.
- Compara el documento formateado con el original. Confirma que nombres, valores, referencias de entidades, declaraciones de namespace y datos de texto no cambiaron.
- Después del formato, ejecuta el parser XML, validador de esquema o prueba de aplicación que requiera el proyecto. Formatear por sí solo no demuestra validez ni compatibilidad.
- Para datos de producción, elimina secretos e información personal de la muestra. Conserva el archivo original para una comparación controlada y una posible reversión.
Método de formato
- Leer la estructura XML
La herramienta lee el marcado como contenido XML anidado e identifica límites de elementos, atributos, texto, comentarios y declaraciones que puede organizar.
- Aplicar indentación
El formateador añade saltos de línea e indentación para mostrar las relaciones entre padres e hijos. Ese espacio es presentación, no una nueva regla de esquema.
- Conservar valores técnicos
Los valores de atributos, referencias de entidades, prefijos de namespace y comentarios deben seguir ligados a la muestra original. Revisa un diff cuando importen los bytes exactos.
La página pública documenta entrada XML para formato. El comportamiento exacto de recuperación del parser, la política de espacios y los mensajes de error requieren una prueba en un motor real.
Leer el resultado formateado
Un resultado exitoso es una disposición legible del XML suministrado. Confirma que árbol, valores, atributos, comentarios y declaraciones coinciden con el original.
Un fallo indica que la ruta documentada no pudo manejar la entrada. No deduzcas una regla exacta del parser o una ubicación de error sin evidencia del motor correspondiente.
Si el documento falla después en XSD o en una comprobación de aplicación, investiga ese contrato separado. El formato no añade elementos, namespaces ni tipos requeridos.
Errores comunes
Confundir indentación con validación de esquema puede ocultar elementos obligatorios ausentes o atributos inválidos.
Reemplazar entidades escapadas por caracteres visibles puede cambiar datos XML o invalidar el documento.
Ordenar atributos o hijos por preferencia visual puede cambiar el orden esperado por un consumidor o alterar contenido mixto.
Copiar solo un fragmento sin su declaración namespace puede hacer que la prueba no se parezca al documento de producción.
Limitaciones
La capacidad documentada es el formato XML. No demuestra validación XSD o DTD, transformación, canonicalización, análisis de seguridad ni compatibilidad de aplicación.
Prueba con el consumidor objetivo el contenido mixto sensible a espacios, namespaces, documentos grandes y la recuperación específica del parser.
No pegues documentos de producción confidenciales salvo que tu política lo permita. La copia formateada puede conservar los mismos valores sensibles.
Examples
Formatear un elemento simple
¿Se puede hacer legible un elemento compacto?
Envía el XML compacto.
Los elementos hijos aparecen en líneas separadas e indentadas bajo note.
Mantener atributos visibles
¿Cómo se revisa un elemento con atributo?
Envía el elemento e inspecciona la etiqueta inicial.
El atributo id permanece en user y el hijo name queda indentado.
Conservar texto escapado
¿Puede permanecer una entidad dentro del texto?
Formatea el documento y compara el nodo de texto.
La referencia de entidad sigue formando parte de la representación textual.
Formatear hijos repetidos
¿Se pueden separar claramente elementos repetidos?
Envía el padre con dos hijos item.
Cada hijo repetido aparece en su propia línea y el orden es más visible.
Conservar un comentario
¿Qué debe ocurrir con un comentario XML?
Formatea la muestra de configuración.
El comentario permanece entre el padre y el elemento mode.
Conservar una declaración
¿Cómo se trata una declaración XML?
Envía la declaración junto con el elemento raíz.
La declaración queda al principio y el contenido de root se indenta debajo.
Frequently asked questions
¿Formatear valida un esquema XML?
No. El formato organiza la estructura XML. Usa el XSD, DTD o validador de aplicación requerido para comprobar el esquema.
¿El formato cambia los valores de los elementos?
Debe conservar valores y estructura y añadir espacios de presentación. Compara la salida con el original cuando el texto exacto importe.
¿Se conservan los comentarios?
Los ejemplos tratan comentarios como contenido que permanece en la vista formateada. Confirma el comportamiento para tu entrada antes de usarlo en un pipeline.
¿Puedo formatear un fragmento XML?
Usa un documento completo o una forma de fragmento documentada. El fragmento puede depender de un namespace o raíz que no está en la muestra.
¿El formato hace XML más pequeño?
No. Normalmente añade espacios para facilitar la lectura. Usa un minificador o proceso de transporte separado para una salida compacta.
¿Qué ocurre con ampersand escapado?
Conserva referencias como & como datos XML. No las sustituyas por ampersand sin escapar si el contexto deja de ser XML válido.
¿El formato repara XML mal formado?
No lo des por hecho. Corrige el origen de manera deliberada y verifícalo con el parser y el esquema que usa la aplicación.
¿Qué hago después de formatear?
Revisa un diff, ejecuta las comprobaciones de parser o esquema y prueba la copia con el consumidor real si importan espacios o namespaces.