도움말

XML 검사기

XML을 붙여넣으면 형식이 올바른지 바로 XML 검사를 해 줘요. 오류가 있으면 첫 번째 오류를 줄과 열, 그리고 쉬운 말로 보여 줘요. XSD 스키마를 추가하면 구조까지 확인하고, 올바른 문서는 정리된 모양으로 돌려줘요. 모든 처리는 브라우저 안에서 이루어지므로 XML은 업로드되지 않아요.


XML 파일 검사하는 방법

  1. XML 붙여넣기를 누르면 클립보드의 내용이 XML 칸으로 들어가요. 직접 붙여넣어도 돼요. 붙여넣는 즉시 문서를 검사해요.
  2. 텍스트를 고친 뒤 다시 검사하려면 검사를 누르세요.
  3. 버튼 아래에서 결과를 확인하세요. 초록색 올바른 XML 상자는 문서의 형식이 올바르다는 뜻이에요. 빨간색 형식이 올바르지 않은 XML 상자에는 오류가 하나 표시돼요.
  4. 오류가 있으면 상자에 줄과 열, 그 줄의 일부(열 아래에 화살표 표시), 편집기에서 보기 버튼이 나와요. 편집기도 그 줄로 스크롤돼요.
  5. 첫 번째 오류를 고친 뒤 다시 검사하세요. 일부러 첫 번째 오류만 보여 줘요. 뒤의 오류는 닫는 태그가 빠진 경우처럼 첫 번째 오류 때문에 생기는 경우가 많아요.

입력은 붙여넣기만 가능하고, 파일 선택 기능은 없어요. 파일을 텍스트 편집기로 열어 전체를 복사한 뒤 칸에 붙여넣으세요.

XML 문법 검사: 형식이 올바른 XML이란

첫 번째 검사는 문법만 봐요. 다음 규칙을 지키면 형식이 올바른 문서예요.

형식이 올바른 것과 유효한 것은 달라요. 유효하다는 것은 문서가 스키마도 따른다는 뜻이고, 아래의 XSD 옵션이 그 용도예요.

자주 나오는 XML 오류와 해결 방법

오류마다 파서의 원문 메시지 대신 한 문장으로 설명해 줘요. 가장 자주 만나는 경우는 이래요.

제어 문자처럼 XML에서 금지된 문자, 끝나지 않은 시작 태그, 닫히지 않은 주석도 알려 줘요.

XML을 XSD 스키마로 확인하기

형식이 올바른 문서도 목적에는 맞지 않을 수 있어요. 숫자 자리에 텍스트가 있거나, 필수 요소가 빠졌거나, 요소가 엉뚱한 곳에 있는 경우예요. 스키마는 허용되는 내용을 설명한 것이고, 이 도구는 그 기준에 맞는지 확인할 수 있어요.

  1. 톱니바퀴 버튼인 고급 옵션을 누르세요.
  2. XSD 스키마(선택)에 스키마를 붙여넣으세요. 형식이 올바른지만 보려면 비워 두세요.
  3. XML 칸에 XML을 붙여넣고 검사를 누르세요.

XML이 스키마와 맞지 않으면 결과에 "스키마와 일치하지 않아요"라는 제목과 오류 개수가 나오고, 최대 100개까지 목록으로 보여 줘요. 항목마다 요소의 XPath(/note/n[1], 속성이면 /note/@id), 쉬운 문장, 줄이 나와요. 확인하는 내용은 다음과 같아요.

문제가 XML이 아니라 스키마에 있으면 따로 상자가 나와요. XSD 스키마가 올바른 형식의 XML이 아니에요 또는 XSD 스키마를 사용할 수 없어요라고 알려 주고, XML은 그 스키마로 검사하지 않아요. 다른 파일을 가져오거나 포함하는 스키마는 아무것도 불러오지 않기 때문에 사용할 수 없어요. 모든 정의를 하나의 XSD에 넣으세요. XSD 1.0을 지원해요.

XML 포맷터: 보기 좋게 정리하기

문서가 올바르면 결과 위에 복사 버튼이 있는 정리된 XML 영역이 나타나요. 너비는 고급 옵션의 들여쓰기에서 공백 2칸, 공백 4칸, 탭 중에 고르세요. 바꾸면 결과가 바로 갱신돼요. 정리는 xmllint --format을 따르기 때문에 결과를 예측하기 쉬워요.

출력이 아주 길면 잘라서 보여 주고, 몇 줄을 보여 주는지 안내해요. 복사는 언제나 문서 전체를 복사해요.

큰 XML 파일과 검사하지 않는 것

검사는 백그라운드의 Web Worker에서 실행돼요. 아주 큰 문서가 느린 이유는 대부분 브라우저가 그만큼의 텍스트를 칸에 그려야 하기 때문이에요. 테스트에서는 60만 줄이 넘는 50 MB 문서가 붙여넣기부터 결과까지 약 30초, 20 MB 문서는 약 11초 걸렸어요. 한도는 1억 2천만 자이고, 넘으면 더 작은 부분을 붙여넣으라고 안내해요.

검사하지 않는 것은 이래요. DTD 검증은 없고, 아무것도 불러오지 않기 때문에 외부 엔티티와 파일도 불러오지 않아요. 지원하는 것은 XSD 1.0뿐이에요. ISO-8859-1이나 UTF-16 같은 선언된 인코딩은 붙여넣은 텍스트가 이미 유니코드이므로 무시해요. 엄청난 양의 텍스트로 확장되는 엔티티를 정의한 문서와 2048단계를 넘게 중첩된 태그는 거부해요.


자주 묻는 질문

XML이 올바른 형식인지 어떻게 검사하나요?

XML을 "XML" 칸에 붙여넣고 "검사"를 누르세요. 초록색 "올바른 XML" 상자는 모든 태그가 닫혀 있고 알맞게 중첩되어 있으며 루트 요소가 하나라는 뜻이에요. 빨간색 "형식이 올바르지 않은 XML" 상자는 첫 번째 오류를 줄과 열, 쉬운 말로 알려 줘요.

형식이 올바른 XML이란 무엇인가요?

문법 규칙을 지키는 XML이에요. 루트 요소가 하나이고, 모든 시작 태그가 올바른 순서의 끝 태그로 닫혀 있고, 속성 값이 따옴표 안에 있고, 한 태그에 같은 속성이 반복되지 않고, &처럼 특수한 문자를 &로 써요. 이 중 하나라도 어기면 파서가 문서를 받아들이지 않아요.

형식이 올바른 XML과 유효한 XML은 뭐가 다른가요?

형식이 올바르다는 것은 문법이 맞다는 뜻이에요. 엄격한 의미의 유효함은 어떤 요소와 값이 허용되는지 정한 스키마(XSD나 DTD)도 따른다는 뜻이에요. 여기서 "올바른 XML"은 XSD 칸이 비어 있으면 형식이 올바르다는 뜻이고, XSD를 붙여넣었다면 형식이 올바르면서 스키마에도 맞는다는 뜻이에요. DTD 검증은 지원하지 않아요.

XML에서 "opening and ending tag mismatch"는 무슨 뜻인가요?

끝 태그가 그 지점에서 열려 있는 태그와 맞지 않는다는 뜻이에요. 끝 태그가 빠졌거나 철자가 틀렸거나 두 태그가 겹친 경우예요. 이 도구는 "닫는 태그 가 1행의 여는 태그 와 맞지 않아요"처럼 알려 줘요. 뒤의 오류는 첫 번째 오류 때문에 생기는 경우가 많으니, 처음 나온 오류를 고친 뒤 다시 검사하세요.

XML에서 "extra content at the end of the document"가 나오는 이유는 무엇인가요?

루트 요소가 끝난 뒤에 무언가 더 있기 때문이에요. 대개 두 번째 루트 요소이고, 예를 들어 레코드 두 개를 이어서 붙여넣은 경우예요. XML 문서의 루트 요소는 정확히 하나예요. 레코드를 하나의 부모 요소로 감싸거나 한 번에 하나씩 붙여넣으세요.

XML에서 nbsp 엔티티가 정의되어 있지 않다고 나오는 이유는 무엇인가요?

는 HTML 엔티티예요. XML이 미리 정의한 것은 <, >, &, ", '뿐이에요. 줄바꿈 없는 공백에는 문자 참조  를 쓰거나 문자 자체를 입력하거나 DTD에 엔티티를 선언하세요. 엔티티를 시작하지 않는 홀로 쓴 &는 &로 써야 해요.

"XML declaration allowed only at the start of the document"는 무슨 뜻인가요?

<?xml ...?> 선언은 문서의 맨 처음에만 올 수 있고, 그 앞에는 아무것도 없어야 해요. 대개 앞에 빈 줄, 공백, 주석이 있어요. 선언 앞에 있는 것을 지우면 오류가 사라져요.

XML을 검사하면 업로드되나요?

아니요. 검사는 내 기기의 브라우저 안에서 이루어지고, 아무것도 업로드하거나 저장하지 않아요. 붙여넣은 XSD 스키마도 마찬가지예요.