갈루아의 반서재

728x90
핵심 요약
HTML 태그를 문자 그대로 보여 주려면 코드블록 안에서 꺾쇠를 문자 참조로 바꾸세요.

티스토리에 HTML 예제를 붙였더니 태그가 사라지고 내용만 보인다면, 브라우저가 그 부분을 실제 마크업으로 해석했을 수 있습니다. 예제를 화면에 문자 그대로 보여 주려면 코드블록과 문자 참조의 역할을 구분해서 적용하면 됩니다.

인라인 코드와 여러 줄 코드 구분

본문 중에서 태그 이름 하나를 언급할 때는 code가 적합합니다.

들여쓰기와 줄바꿈이 있는 예제는 pre 안에 code를 배치하면 원래 형태를 보존할 수 있습니다.

예를 들어 HTML 태그 하나를 설명하는 문장과 전후 문단이 포함된 전체 예제는 표시 방식이 달라집니다.

꺾쇠와 앰퍼샌드 처리하기

HTML 편집기에서 예제로 보여 줄 여는 꺾쇠는 <로, 닫는 꺾쇠는 >로 표기할 수 있습니다.

원문에 앰퍼샌드가 있다면 &가 필요합니다.

자동 변환 도구에서 문자열 치환으로 처리한다면 앰퍼샌드를 먼저 변환해야 방금 생성한 문자 참조까지 다시 바뀌는 문제를 피할 수 있습니다.

미리보기에서 복사해 원문과 비교하기

예제에 태그 한 줄, 앰퍼샌드가 포함된 URL, 두 줄 이상의 들여쓰기를 넣어 보세요.

미리보기에서 표시된 글자를 복사해 원문과 비교하면 이중 이스케이프와 누락을 확인하기 좋습니다.

긴 코드 줄은 좁은 화면에서 코드 영역을 스크롤할 수 있는지 살펴보고 필요한 경우 예제 자체를 짧게 나눕니다.

발행 전 확인

수정 전 사본을 남기고, 미리보기에서 본문을 위에서 아래로 읽으며 소제목과 예시가 의도한 순서로 표시되는지 확인합니다.

실습 · HTML 태그가 사라지거나 이중으로 표시될 때

독자에게 <p>안녕하세요</p>를 보여 주려면 HTML 모드에서 아래처럼 문자 참조를 사용합니다.

<pre><code>&lt;p&gt;안녕하세요&lt;/p&gt;</code></pre>
  • 화면에 ‘안녕하세요’만 보이면 태그가 마크업으로 해석된 경우를 먼저 확인합니다.
  • 화면에 &lt;p&gt;가 보이면 꺾쇠가 이중 처리됐는지 확인합니다.
  • 예제의 URL에 앰퍼샌드가 있으면 미리보기에서 복사해 원문 주소와 비교합니다.

자동 정리 도구를 검증할 때는 입력이 일반 텍스트인지 이미 이스케이프된 HTML인지 구별하고, 결과를 복사했을 때 독자가 실행할 원문과 같은지도 확인하세요.

참고 자료 · MDN

이미지 출처 · Pexels

728x90