HTML 포매터

HTML 포매터는 브라우저의 HTML 파서를 이용해 문서 구조를 해석한 뒤 블록 요소를 계층적으로 들여쓰고 문장 안의 인라인 요소는 같은 줄에 유지합니다.

문서와 조각 모드

입력 범위에 따라 파싱 결과에 포함할 노드가 달라집니다.

• HTML 문서 모드는 doctype, html, head와 body를 포함한 전체 문서를 출력합니다.
• HTML 조각 모드는 body 안에 들어갈 일부 마크업만 출력해 컴포넌트 편집에 적합합니다.
• 브라우저 파서는 생략된 html·head·body 또는 닫는 태그를 표준 규칙에 따라 보완할 수 있습니다.

인라인 문장 보존

문장 안 태그를 무조건 새 줄로 나누면 렌더링 공백이 달라질 수 있습니다.

• strong, em, a, span 같은 인라인 요소와 주변 문장을 한 줄에 유지합니다.
• div, section, table, li 같은 블록 요소는 부모·자식 깊이에 따라 들여씁니다.
• 일반 텍스트 공백 정리를 끄면 텍스트 노드의 원래 공백을 더 많이 유지합니다.

특수 요소 처리

내용 자체의 줄바꿈이 중요한 요소는 일반 HTML 요소와 다르게 다룹니다.

• script, style, pre와 textarea 내용은 내부 문자열을 다시 해석하지 않고 줄 단위로 보존합니다.
• img, meta, input, br 같은 빈 요소에는 잘못된 닫는 태그를 만들지 않습니다.
• 주석은 노드 위치에 맞춰 유지하고 닫히지 않은 주석은 오류로 안내합니다.

결과 사용 주의

포맷팅은 코드 정리 기능이며 HTML 보안 검사나 완전한 문법 검증이 아닙니다.

• 입력한 script와 이벤트 속성은 제거하지 않으므로 신뢰할 수 없는 HTML을 실행하지 마세요.
• 템플릿 엔진 문법, 서버 지시문과 비표준 태그는 브라우저 파싱 과정에서 달라질 수 있습니다.
• 운영 적용 전 원본과 비교하고 실제 페이지의 접근성·레이아웃·스크립트를 다시 테스트하세요.