XML 포매터

SOAP 서비스, RSS 피드, 설정 내보내기에서 나온 압축된 XML 덤프는 한 줄로는 읽을 수 없습니다. 이 포매터는 문서를 파싱해 공백 2칸의 일관된 들여쓰기로 재구성하고, 속성 순서와 CDATA 섹션을 보존하며, 적격성 문제를 줄 번호와 함께 보고해 어긋난 태그를 찾아 헤매지 않고 고칠 수 있게 합니다.

XML을 포맷하는 방법

  1. 1

    XML 붙여넣기

    UTF-8 XML을 최대 20만 자까지 붙여 넣을 수 있습니다. XML 선언은 그대로 유지됩니다.

  2. 2

    포맷

    파서가 DOM을 만든 뒤 일관된 간격으로 다시 직렬화합니다.

  3. 3

    결과 복사

    출력은 로그나 문서에 바로 붙여넣을 수 있는 적격 XML입니다.

포맷이 보존하는 것

  • XML 선언은 따옴표, 인코딩 이름, standalone 값까지 입력한 그대로 유지됩니다. 선언이 없는 XML에는 선언이 붙지 않습니다. 눈에 보이는 문자는 그대로 쓰이며(한글, 아랍어, 악센트가 있는 문자, 이모지 등), é 같은 숫자 문자 참조는 é가 됩니다. 결과는 UTF-8이므로, 선언에 다른 인코딩(예: ISO-8859-1)이 적혀 있다면 파일을 저장하기 전에 UTF-8로 바꾸세요.
  • 문서 유형과 외부 DTD만 지정하는 DOCTYPE 선언(Apple plist, MyBatis 매퍼, Hibernate 설정 파일 등)은 유지되며, DTD를 내려받지 않습니다. 내부 서브셋([...])이나 ENTITY 선언이 포함된 DOCTYPE, 그리고 http, https, 상대 경로가 아닌 DTD 주소는 허용되지 않습니다.
  • 처리 명령어 (<?xml-stylesheet ?>)를 자체 줄에 유지.
  • 주석을 문맥에 따라 자체 줄 또는 인라인에.
  • CDATA 섹션을 내부 공백 포함 정확히 보존.
  • 속성 값을 큰따옴표가 없으면 큰따옴표로, 있으면 작은따옴표로 다시 인용.
  • 참조: &amp;, &lt;, &gt;는 그대로 둡니다. 보이지 않거나 텍스트 방향을 바꾸는 문자(U+202E, 폭 없는 공백 등)는 텍스트와 속성 값에서 &#x202E; 같은 숫자 문자 참조로 쓰이므로 눈으로 확인할 수 있습니다. 주석과 CDATA 섹션에서는 입력한 그대로 남습니다.

들여쓰기 예시

입력(압축됨):

<books><book id="1"><title>1984</title><author>George Orwell</author></book></books>

포맷됨(공백 2칸):

<books>
  <book id="1">
    <title>1984</title>
    <author>George Orwell</author>
  </book>
</books>

도구가 잡아내는 흔한 오류

오류 해결
어긋난 닫는 태그 여는 이름과 닫는 이름 맞추기
닫히지 않은 요소 닫는 태그 추가
태그 이름의 잘못된 문자 태그 이름은 글자나 밑줄로 시작해야 함
같은 요소의 중복 속성 중복 제거
잘못된 CDATA <![CDATA[와 ]]> 짝 확인
텍스트에 이스케이프되지 않은 < 또는 & &lt; 또는 &amp; 사용

적격성 대 유효성

  • 적격한(well-formed) XML은 구문 규칙을 따릅니다: 균형 잡힌 태그, 유효한 문자, 올바른 중첩. 포매터는 이를 확인합니다.
  • 유효한(valid) XML은 추가로 스키마(DTD 또는 XSD)를 따릅니다. 그것을 확인하려면 XSD 검증기를 사용하세요.

XML 문서는 유효하지 않으면서 적격할 수 있지만, 그 반대는 안 됩니다.

실용적 참고

  • XML 속성 순서는 일부 시스템(현대 시스템은 많지 않음)에 의미가 있습니다, 포매터는 입력 순서를 보존합니다.
  • 자체 닫음 vs 명시적 빈 태그: <foo/>와 <foo></foo>는 XML에서 동등합니다. 포매터는 모든 빈 요소를 <foo/>로 씁니다.
  • 네임스페이스 접두사는 정확히 보존됩니다.

자주 묻는 질문

네. 혼합 콘텐츠 요소와 CDATA 섹션 안의 텍스트는 그대로 유지됩니다. 요소 사이의 공백만 들여쓰기를 위해 조정됩니다.

네. 한 번에 최대 20만 자까지 붙여 넣을 수 있고, 요소 하나에는 속성을 최대 256개까지 둘 수 있습니다. 더 큰 파일에는 명령줄의 xmllint 같은 스트리밍 포매터를 사용하세요.

네. 네임스페이스 선언은 작성한 요소에 그대로 남고, 접두사도 정확히 보존됩니다.

아니요. XML은 포맷을 위해 저희 서버로 전송되지만 서버에 저장되지는 않습니다. 단계를 오가는 동안 붙여 넣은 내용은 이 브라우저 탭에만 보관됩니다.

관련 도구

이 도구는 다른 언어로도 제공됩니다