본문으로 건너뛰기

HTML, CSS, JS 플레이그라운드 — 실시간 미리보기 온라인 코드 에디터

HTML, CSS, JavaScript를 나란히 작성하고 콘솔과 함께 결과를 실시간으로 확인한 뒤, 링크로 공유하거나 .html 파일 하나로 다운로드하세요.

문제를 발견하셨거나 개선할 점이 있나요? 모든 메시지를 읽고 빠르게 고칩니다.

이 HTML, CSS, JS 플레이그라운드는 실시간 미리보기가 있는 온라인 코드 에디터입니다. 세 개의 에디터에 마크업, 스타일, JavaScript를 작성하면 옆의 페이지가 입력하는 대로 업데이트됩니다. 아래쪽 콘솔에는 코드가 출력하는 로그와 발생한 오류가 JavaScript 줄 번호와 함께 표시되므로, 브라우저 개발자 도구를 열지 않고도 디버깅할 수 있습니다. 프로젝트를 새로 구성하기엔 과한 순간을 위한 도구입니다. CSS 레이아웃을 시험해 보거나, 동료에게 버그를 재현해 보여 주거나, 튜토리얼의 코드 조각을 테스트하거나, 누군가에게 첫 웹 페이지를 가르칠 때 쓰세요.

코드는 브라우저에 자동 저장되므로 탭을 닫아도 사라지지 않습니다. 공유 링크는 세 에디터의 내용을 링크 자체에 압축해 넣습니다. 서버에는 아무것도 저장되지 않으며, 링크를 연 사람은 누구나 똑같은 사본을 받습니다. 다운로드하면 CSS와 JavaScript가 인라인으로 들어간 .html 파일 하나가 생기며, 어떤 브라우저에서도 열립니다. 미리보기는 샌드박스 프레임에서 실행됩니다. 그래서 공유 링크를 안전하게 열 수 있지만, 그 안에서는 localStorage 같은 몇 가지 기능이 작동하지 않습니다. 자세한 내용은 아래에 있습니다.

사용 방법

  1. HTML, CSS, JavaScript 에디터에 코드를 입력하거나 붙여 넣으세요. HTML은 페이지의 body이며, 자체 <head>가 있는 전체 문서를 붙여 넣어도 됩니다.
  2. 미리보기가 업데이트되는 것을 확인하세요. 반복문을 작성하는 중이라 준비됐을 때만 실행하고 싶다면 자동 실행을 끄고 실행 또는 Ctrl+Enter(Mac은 ⌘+Enter)를 누르세요.
  3. 미리보기 아래 콘솔 패널에서 console.log 출력, 경고, 오류를 확인하세요. 오류에는 발생한 JavaScript 줄이 표시됩니다.
  4. 레이아웃을 에디터 위쪽 배치와 에디터 왼쪽 배치 중에서 전환하세요. 휴대폰에서는 에디터가 탭으로 바뀝니다.
  5. 공유 링크를 눌러 코드가 담긴 링크를 복사하거나, .html 다운로드를 눌러 독립 실행형 파일 하나로 저장하세요.

자주 묻는 질문

다른 사람이 보낸 플레이그라운드 링크를 열어도 안전한가요?

모르는 웹사이트를 여는 것보다는 안전하며, 저절로 실행되지도 않습니다. 공유 링크는 먼저 코드를 보여 주고, 실행을 눌러야만 실행됩니다. 실행될 때도 allow-same-origin 없이 샌드박스 처리된 iframe 안에서 돌아가므로 브라우저는 이를 별개의 익명 출처로 취급합니다. 따라서 이 사이트의 localStorage(내 초안이 저장된 곳), 쿠키, 주변 페이지를 읽을 수 없습니다. 다만 콘텐츠를 표시하거나 다른 사이트로 요청을 보내는 등 프레임 안의 웹 페이지가 할 수 있는 일은 여전히 할 수 있으니, 모르는 사람의 코드는 모르는 사람이 보낸 링크처럼 대하세요.

미리보기에서 localStorage나 sessionStorage가 오류를 내는 이유는 무엇인가요?

샌드박스 때문입니다. 미리보기 프레임은 불투명 출처를 가지며, 브라우저는 불투명 출처에 대해 저장소, 쿠키, IndexedDB 사용을 SecurityError로 거부합니다. 공유된 코드를 안전하게 열기 위한 대가입니다. 저장소를 쓰는 코드를 테스트하려면 .html 파일을 다운로드해 로컬 웹 서버에서 열거나, 저장소 호출을 try/catch로 감싸 나머지 코드가 실행되도록 하세요.

공유 링크는 어떻게 작동하며 크기 제한이 있나요?

세 에디터의 내용을 JSON으로 묶고 브라우저 내장 deflate(CompressionStream)로 압축해 링크의 # 뒷부분에 씁니다. 이 부분은 서버로 전송되지 않으므로 코드는 링크 안에만 존재합니다. 실제 코드로 측정하면 링크 길이는 1 KB 코드 조각에서 코드 길이의 약 85%, 8 KB에서 60%, 40 KB에서 35%입니다. 코드가 많을수록 압축 효과가 커지기 때문입니다. 브라우저는 아주 긴 링크도 받아들이지만 채팅 앱, 이메일 클라이언트, 일부 URL 단축 서비스는 긴 링크를 잘라 버립니다. 도구는 8,000자를 넘으면 경고하며, 큰 프로젝트는 .html 다운로드로 공유하는 편이 낫습니다.

npm 패키지, React, ES 모듈을 쓸 수 있나요?

빌드 단계가 없으므로 npm으로는 쓸 수 없습니다. 브라우저 스크립트나 ES 모듈로 배포된 라이브러리라면 CDN에서 불러올 수 있습니다. HTML 에디터에 <script src="…"></script>를 넣거나, 그곳에 <script type="module"> 블록을 작성하고 esm.sh나 jsDelivr 같은 URL에서 import하세요. JavaScript 에디터는 클래식 스크립트로 실행되므로 그곳의 import 문은 구문 오류가 됩니다. 모듈 코드는 HTML 에디터에 넣으세요. JSX와 TypeScript는 컴파일되지 않습니다.

코드 때문에 페이지가 멈췄어요. 무슨 일인가요?

거의 항상 무한 루프 때문입니다. 예를 들어 조건이 절대 false가 되지 않는 while 루프 같은 경우입니다. JavaScript는 단일 스레드에서 실행되므로 끝나지 않는 루프는 미리보기를 응답하지 않게 만들고, 샌드박스 프레임을 페이지와 같은 프로세스에서 실행하는 브라우저에서는 탭 전체가 함께 멈춥니다. 탭을 닫았다가 다시 여세요. 플레이그라운드가 자동 저장하므로 코드는 그대로 남아 있습니다. 반쯤 입력한 코드가 키를 누를 때마다 실행되지 않도록 루프를 작성하기 전에는 자동 실행을 끄세요.

이 플레이그라운드는 내 코드를 업로드하거나 저장하나요?

아니요. 에디터, 미리보기, 콘솔은 모두 브라우저에서 실행되고, 자동 저장은 브라우저의 로컬 저장소에 되며, 공유 링크는 코드를 링크 안에 담습니다. 입력한 내용은 이 사이트로 전송되지 않습니다. 다만 미리보기 자체는 글꼴, 이미지, CDN 스크립트 등 코드가 요청하는 리소스를 불러올 수 있습니다.

샌드박스가 허용하는 것과 막는 것

미리보기는 srcdoc으로 내용을 설정하고 sandbox 속성이 "allow-scripts allow-modals allow-forms"인 <iframe>입니다. 각 플래그는 의도적으로 선택한 것입니다.

• allow-scripts: JavaScript가 실행됩니다.

• allow-modals: 초보자가 자주 쓰는 alert(), confirm(), prompt()가 작동합니다.

• allow-forms: <form>을 제출할 수 있어 폼 유효성 검사를 테스트할 수 있습니다.

• allow-same-origin 없음: 프레임은 고유한 불투명 출처를 받습니다. 이 사이트의 저장소나 쿠키를 읽을 수 없고, 페이지도 프레임 안을 읽을 수 없습니다. 콘솔은 프레임이 메시지를 바깥으로 보내는 방식으로 작동하며, 페이지는 현재 미리보기에서 온 메시지만 받아들입니다.

• allow-popups와 allow-top-navigation 없음: 공유된 코드는 창을 열거나 사용자를 다른 페이지로 이동시킬 수 없습니다.

실행할 때마다 프레임을 새것으로 교체하므로 이전 실행의 타이머, 이벤트 리스너, 전역 변수가 다음 실행으로 새어 나가지 않습니다.

HTML, CSS, JavaScript를 합치는 방식

HTML 에디터에 조각(<html>, <head>, doctype 없음)만 있으면 플레이그라운드가 이를 UTF-8 charset과 모바일 viewport 태그가 있는 표준 HTML5 문서로 감싸고, CSS는 head의 <style> 요소에, JavaScript는 body 끝의 <script>에 넣습니다. 스크립트를 마지막에 실행하므로 querySelector로 찾는 요소가 이미 존재하며, 그래서 시작 코드에 DOMContentLoaded 리스너가 필요 없습니다.

완전한 문서를 붙여 넣으면 그 구조가 유지됩니다. CSS는 <head>의 시작 부분에, JavaScript는 </body> 바로 앞에 들어갑니다. 다운로드한 .html 파일도 콘솔 연결 부분만 빼고 같은 방식으로 만들어지므로 미리보기와 똑같이 동작합니다.

JavaScript 안에 문자열 등으로 "</script>"가 그대로 들어 있으면 script 요소가 일찍 끝나 버립니다. 플레이그라운드는 이를 JavaScript에서 같은 뜻인 "<\/script>"로 바꿔 쓰므로, 그런 코드도 수정 없이 작동합니다.

플레이그라운드 vs CodePen, JSFiddle, 로컬 에디터

CodePen, JSFiddle 같은 사이트는 계정, 저장 컬렉션, 전처리기(Sass, TypeScript, Babel), npm 방식의 패키지 검색, 커뮤니티 피드를 제공합니다. 이런 기능이 필요하다면 그쪽을 쓰세요. 이 플레이그라운드는 의도적으로 더 작게 만들었습니다. 즉시 열리고, 계정이 필요 없고, 작업 내용을 내 브라우저에 보관하며, 공유 링크가 누군가의 서버 가동 여부에 의존하지 않습니다.

한 페이지보다 큰 작업에는 개발 서버(Vite 또는 Live Server 확장)와 함께 VS Code 같은 로컬 에디터를 쓰는 것이 맞습니다. 여러 파일, 실제 모듈, 디버거, 버전 관리를 쓸 수 있습니다. .html 다운로드는 둘을 잇는 다리 역할을 하며, 프로젝트에 바로 넣을 수 있는 작동하는 파일을 제공합니다.