개발도구 · 2026년 7월 8일 · 읽는 시간 4분
HTML 기본 구조 외우기 귀찮아서 만든 템플릿 생성기
새 HTML 파일 만들 때마다 기본 구조 타이핑하는 게 귀찮다. 빠진 거 있는지도 불안하고.
HTML 보일러플레이트가 필요한 상황
이런 경우들:
- 빠른 프로토타입 → 프레임워크 없이 순수 HTML
- 이메일 템플릿 → 이메일용 HTML 구조는 웹과 다름
- 랜딩페이지 → 간단한 정적 페이지
- HTML 강의/교육 → 학생들에게 나눠줄 시작 파일
- GitHub Pages → 정적 사이트 빠르게 올릴 때
- 코딩 테스트 → 제한 시간 내에 빠르게 시작
VS Code에서 ! + Tab으로 Emmet 자동완성 쓰면 되는데, 거기서 빠진 것들(OG 태그, 파비콘, 다크모드 meta)을 자꾸 찾아봐야 해서 불편했다.
좋은 HTML 기본 구조란
<!DOCTYPE html> <html lang="ko"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta name="description" content=""> <meta property="og:title" content=""> <meta property="og:description" content=""> <meta property="og:image" content=""> <title>페이지 제목</title> <link rel="icon" type="image/x-icon" href="/favicon.ico"> <!-- CSS --> </head> <body> <!-- 내용 --> <!-- Scripts --> </body> </html>
포함되어야 할 것들:
lang속성 → 스크린 리더, 검색엔진용charset=UTF-8→ 한글 깨짐 방지viewport→ 모바일 대응description→ SEO- OG 태그 → SNS 공유 미리보기
- 파비콘 → 브라우저 탭 아이콘
기존 방법의 문제
- Emmet ! 단축키 → 기본 구조만 나옴, OG 태그 없음
- 이전 프로젝트에서 복붙 → 이전 프로젝트 정보가 섞여 들어옴
- 온라인 검색 → "html boilerplate 2024" 검색하면 오래된 글 많음
- 기억에 의존 → 뭔가 빠트린 것 같은 불안감
그래서 만들었음
옵션별로 원하는 것만 골라서 생성:
- 언어 선택 (한국어/영어 → lang 속성)
- 타이틀 입력
- SEO 메타태그 포함 여부
- OG 태그 포함 여부
- 파비콘 포함 여부
- CSS 초기화 (reset, normalize) 포함 여부
- Tailwind CSS CDN 포함 여부
- Bootstrap CDN 포함 여부
- 다크모드 prefers-color-scheme 포함 여부
Tailwind 포함 버전 예시
<!DOCTYPE html>
<html lang="ko" class="h-full">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>내 페이지</title>
<script src="https://cdn.tailwindcss.com"></script>
</head>
<body class="h-full bg-white dark:bg-gray-900">
<div class="container mx-auto px-4 py-8">
<h1 class="text-3xl font-bold text-gray-900 dark:text-white">
Hello World
</h1>
</div>
</body>
</html>프로토타이핑할 때 Tailwind CDN 버전 쓰면 빠르다. 물론 배포용에는 빌드 도구 설정해야 하지만 로컬 테스트엔 이게 더 빠름.
실제로 써보니
좋은 점:
- 체크박스로 필요한 것만 골라서 생성
- 복사 버튼 하나로 끝
- OG 태그, 다크모드 등 자주 빠트리는 것들 포함
- 최신 HTML 관행 반영
한계:
- React/Vue 같은 SPA 보일러플레이트는 각 CLI 도구 쓰는 게 나음
- 복잡한 프로젝트 구조 생성은 안 됨
사용법
- 타이틀, 언어 입력
- 포함할 기능 체크박스 선택
- 생성 버튼 클릭
- 복사해서 새 HTML 파일에 붙여넣기
써보기
새 HTML 파일 시작할 때 기본 구조 빠르게 뽑아서 쓰면 편함.
#HTML보일러플레이트 #HTML템플릿 #웹개발 #프론트엔드 #HTML기본구조