HTML: 문서의 뼈대와 의미

웹 페이지는 결국 HTML이라는 글자 문서예요. 태그, 요소, 속성이 무엇인지부터 시작해 모든 페이지가 갖는 기본 뼈대, 제목과 문단, 링크, 이미지, 목록, 표, 입력 양식 같은 자주 쓰는 요소를 익혀요. 브라우저가 HTML을 나무 구조(DOM)로 읽는 모습을 BeautifulSoup으로 직접 확인하고, div만 쓰지 않고 뜻을 담아 쓰는 태그가 화면 낭독기와 검색 엔진과 스크래핑에 왜 중요한지, 누구나 쓸 수 있는 페이지를 만드는 작은 습관까지 다뤄요.

입문강의 1 / 6약 16분

브라우저 주소창에 주소를 치면, 서버는 HTTP 응답으로 글자로 된 문서 하나를 보내 줘요. 네트워크 트랙의 HTTP 강의에서 본 Content-Type: text/html이 바로 그 문서의 종류예요. 이 문서를 쓰는 말이 HTML(HyperText Markup Language)이에요.

HTML은 계산을 하거나 조건에 따라 움직이는 프로그래밍 언어가 아니라, 글에 "여기는 제목", "여기는 링크" 같은 이름표를 붙이는 표시 언어(마크업 언어)예요. 웹 페이지는 보통 세 가지가 함께 만들어요.

맡은 일언어집에 비유하면
내용과 구조HTML뼈대와 방 배치
모양CSS벽지, 가구, 조명
동작자바스크립트전기와 수도, 자동문

이 강의에서는 뼈대를 세우는 법을 배워요. 모양은 다음 강의의 CSS, 동작은 그다음의 자바스크립트가 맡아요.

태그, 요소, 속성

<a href="https://example.com">예제 사이트</a>

이 한 줄에 HTML의 기본이 다 들어 있어요.

  • <a href="https://example.com">은 여는 태그, </a>는 닫는 태그예요. 닫는 태그에는 빗금(/)이 붙어요.
  • 여는 태그부터 닫는 태그까지 전체를 요소라고 해요. 사이의 "예제 사이트"가 요소의 내용이에요.
  • 여는 태그 안의 href="https://example.com"은 속성이에요. 이름="값" 꼴로 요소에 정보를 더해요. a(링크) 요소의 href는 링크가 가리키는 주소예요.

몇 가지 규칙이 더 있어요.

  • 내용이 없는 요소도 있어요. 이미지 <img>, 줄바꿈 <br>, 입력칸 <input>, 정보 <meta>는 닫는 태그 없이 혼자 써요.
  • 요소 안에 요소를 넣을 수 있어요. 이때는 나중에 연 것을 먼저 닫아요. <p><strong>중요</strong>해요</p>처럼요. <p><strong>중요</p></strong>처럼 엇갈리게 닫으면 안 돼요.
  • 태그 이름은 대소문자를 가리지 않지만 소문자로 쓰는 게 관례예요.
  • HTML은 공백과 줄바꿈을 하나의 공백으로 합쳐요. 코드에서 엔터를 다섯 번 쳐도 화면에서는 띄어쓰기 한 칸이에요. 문단을 나누려면 <p> 요소를 써요.

모든 페이지의 기본 뼈대

어떤 웹 페이지든 이 뼈대에서 시작해요.

<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>나의 첫 페이지</title>
  <meta name="description" content="HTML을 처음 배우며 만든 페이지예요.">
</head>
<body>
  <h1>안녕하세요</h1>
  <p>처음 만든 <a href="https://example.com">웹 페이지</a>예요.</p>
</body>
</html>
  • <!DOCTYPE html>: "요즘 표준대로 읽어 주세요"라는 선언이에요. 빼면 브라우저가 옛날 방식으로 읽어서 모양이 어긋날 수 있어요.
  • <html lang="ko">: 문서 전체를 감싸고, 이 문서가 한국어라고 알려 줘요. 화면 낭독기는 이 값을 보고 한국어 발음으로 읽고, 브라우저는 번역을 제안할지 정해요.
  • <head>: 화면에 보이지 않는 페이지에 대한 정보를 담아요.
    • <meta charset="utf-8">: 글자를 UTF-8로 읽으라는 뜻이에요. 빠뜨리면 한글이 깨질 수 있어요. 컴퓨터 기초 트랙의 문자 인코딩 강의에서 본 바로 그 문제예요.
    • viewport: 휴대폰에서 페이지를 손톱만 하게 줄여 보여 주지 않고, 화면 너비에 맞춰 그리게 해요.
    • <title>: 브라우저 탭에 보이는 제목이에요. 검색 결과의 제목으로도 쓰여요.
    • description: 검색 결과에서 제목 아래에 보이는 설명문으로 쓰일 수 있어요.
  • <body>: 화면에 보이는 모든 내용이 여기에 들어가요.

메모장이나 VS Code로 위 내용을 index.html이라는 이름으로 저장하고 더블클릭하면 브라우저에서 바로 열려요. 서버도 인터넷도 필요 없어요. 아무 사이트에서나 Ctrl+U를 누르면 그 페이지의 HTML 원문을 볼 수 있어요.

브라우저는 HTML을 나무로 읽어요

브라우저는 HTML 글자를 그대로 쓰지 않고, 요소들이 서로 감싸는 관계를 나무 구조로 바꿔 기억해요. 이 나무를 DOM(Document Object Model)이라고 해요. 파이썬의 BeautifulSoup(pip install beautifulsoup4로 설치해요)도 같은 나무를 만들어 줘서 직접 들여다볼 수 있어요.

from bs4 import BeautifulSoup, Doctype

html = """<!DOCTYPE html>
<html lang="ko">
<head><meta charset="utf-8"><title>나의 첫 페이지</title></head>
<body>
  <h1>안녕하세요</h1>
  <p>처음 만든 <a href="https://example.com">웹 페이지</a>예요.</p>
  <ul><li>사과</li><li>배</li></ul>
</body>
</html>"""
soup = BeautifulSoup(html, "html.parser")

def show(node, depth=0):
    for child in node.children:
        if isinstance(child, Doctype):
            continue
        if child.name:                                   # 요소
            attrs = " ".join(f'{k}="{v}"' for k, v in child.attrs.items())
            print("  " * depth + child.name + (f"  [{attrs}]" if attrs else ""))
            show(child, depth + 1)
        elif child.strip():                              # 글자
            print("  " * depth + repr(child.strip()))

show(soup)
html  [lang="ko"]
  head
    meta  [charset="utf-8"]
    title
      '나의 첫 페이지'
  body
    h1
      '안녕하세요'
    p
      '처음 만든'
      a  [href="https://example.com"]
        '웹 페이지'
      '예요.'
    ul
      li
        '사과'
      li
        '배'

들여쓰기가 감싸는 관계예요. body는 h1, p, ul의 부모이고, 이 셋은 서로 형제예요. 따옴표로 보이는 것은 글자(텍스트 노드)인데, 이것도 나무의 잎으로 들어가요. p 안을 보면 글자, 링크 요소, 다시 글자가 차례로 섞여 있어요. 출력에서는 보기 좋게 앞뒤 공백을 지웠어요.

이 나무가 앞으로 배울 모든 것의 바탕이에요. CSS는 이 나무에서 요소를 골라 꾸미고, 자바스크립트는 이 나무를 고쳐서 화면을 바꾸고, 스크래핑 도구는 이 나무에서 원하는 부분을 찾아요. 브라우저에서 F12를 눌러 개발자 도구의 Elements(요소) 탭을 열면 지금 페이지의 나무를 볼 수 있어요.

자주 쓰는 요소

요소뜻
h1부터 h6제목. 숫자가 작을수록 큰 단위의 제목
p문단
a링크. href에 주소
img이미지. src에 파일, alt에 내용 설명
ul, ol, li순서 없는 목록, 순서 있는 목록, 목록의 항목
strong, em중요한 말, 힘주어 읽는 말
table, tr, th, td표, 행, 제목 칸, 일반 칸
form, label, input, button입력 양식, 입력칸의 이름표, 입력칸, 버튼
div, span뜻이 없는 묶음. div는 덩어리, span은 글줄 안의 일부

조금 더 실제에 가까운 예를 볼게요.

<h2>오늘의 할 일</h2>
<ol>
  <li>HTML 뼈대 외우기</li>
  <li><a href="/notes/css">CSS 정리</a> 읽기</li>
</ol>

<img src="cat.jpg" alt="창가에서 졸고 있는 고양이" width="320" height="240">

<table>
  <tr><th>요일</th><th>공부 시간</th></tr>
  <tr><td>월</td><td>40분</td></tr>
  <tr><td>화</td><td>25분</td></tr>
</table>

<form action="/search" method="get">
  <label for="q">검색어</label>
  <input id="q" name="q" type="search" required>
  <button type="submit">찾기</button>
</form>
  • 링크 주소가 /로 시작하면 같은 사이트 안의 경로예요. https://로 시작하면 다른 사이트로도 갈 수 있어요.
  • 이미지에 width와 height를 적어 두면, 이미지를 받기 전에도 브라우저가 그만큼 자리를 비워 둬서 글이 갑자기 밀려 내려가지 않아요.
  • 표는 표 모양의 데이터에만 써요. 예전에는 화면 배치를 표로 했지만, 지금은 CSS가 그 일을 해요.
  • 양식은 HTTP 강의와 바로 이어져요. "찾기"를 누르면 브라우저가 /search?q=검색어 주소로 GET 요청을 보내요. name="q"가 쿼리의 이름이 되고, required가 있으면 빈칸일 때 브라우저가 먼저 막아 줘요. type="email"로 바꾸면 휴대폰에서는 @가 있는 자판이 뜨고, 형식이 틀리면 알려 줘요.

뜻을 담는 태그

div와 span만 있어도 화면은 얼마든지 그릴 수 있어요. 하지만 그러면 사람의 눈에만 구조가 보이고, 프로그램에게는 구조가 보이지 않아요. 그래서 HTML에는 역할을 이름으로 가진 태그가 있어요.

태그역할
header머리 부분(사이트 이름, 로고)
nav주요 메뉴
main이 페이지의 본문(한 페이지에 하나)
article따로 떼어도 뜻이 통하는 글 한 편
section제목이 있는 한 덩어리
aside곁들이는 내용(관련 글, 광고)
footer꼬리 부분(저작권, 연락처)

같은 내용을 두 방식으로 쓰고, 프로그램이 본문과 제목을 찾을 수 있는지 볼게요.

from bs4 import BeautifulSoup

div_soup = """
<div class="top"><div class="logo">내 블로그</div><div class="menu">홈 · 소개</div></div>
<div class="wrap"><div class="t">HTML 배우기</div><div class="c">태그는 뜻을 담아요.</div></div>
<div class="bottom">© 2026</div>
"""
semantic = """
<header><p>내 블로그</p><nav>홈 · 소개</nav></header>
<main><article><h1>HTML 배우기</h1><p>태그는 뜻을 담아요.</p></article></main>
<footer>© 2026</footer>
"""
for name, doc in (("div만 쓴 문서", div_soup), ("뜻을 담은 문서", semantic)):
    soup = BeautifulSoup(doc, "html.parser")
    main = soup.find("main") or soup.find("article")
    title = soup.find("h1")
    print(f"{name}: 본문={main.get_text(' ', strip=True) if main else '찾을 수 없음'}"
          f" | 제목={title.get_text() if title else '찾을 수 없음'}")
div만 쓴 문서: 본문=찾을 수 없음 | 제목=찾을 수 없음
뜻을 담은 문서: 본문=HTML 배우기 태그는 뜻을 담아요. | 제목=HTML 배우기

화면에서는 두 문서가 똑같아 보이게 꾸밀 수 있어요. 하지만 div만 쓴 문서에서는 무엇이 본문이고 무엇이 제목인지 프로그램이 알 길이 없어요. class="t"가 제목이라는 건 만든 사람만 아는 약속이니까요. 뜻을 담은 태그로 쓰면 이런 쪽이 도움을 받아요.

  • 화면 낭독기: 눈이 불편한 사람은 화면 낭독기로 "본문으로 바로 가기", "제목만 훑어 듣기" 같은 기능을 써요. main과 제목 태그가 없으면 메뉴부터 꼬리말까지 처음부터 다 들어야 해요.
  • 검색 엔진: 무엇이 본문이고 무엇이 메뉴인지 알아야 페이지의 주제를 정확히 이해해요.
  • 스크래핑: 사이트 모양이 바뀌어도 main, article, h1 같은 태그는 잘 바뀌지 않아서, 데이터를 안정적으로 찾을 수 있어요.
  • 나중의 나: 몇 달 뒤 코드를 다시 열었을 때 구조가 한눈에 보여요.

버튼도 마찬가지예요. div에 클릭 동작을 붙여 버튼처럼 만들 수도 있지만, 진짜 button 요소는 Tab 키로 옮겨 갈 수 있고, Enter나 스페이스로 누를 수 있고, 화면 낭독기가 "버튼"이라고 읽어 줘요. 이걸 div로 흉내 내려면 일이 훨씬 많아요.

제목의 단계는 목차예요

h1부터 h6는 글씨 크기가 아니라 목차의 단계예요. 책의 장, 절, 소절처럼요. 보통 한 페이지에 h1은 하나로 그 페이지의 주제를 쓰고, 그 아래로 h2, h3를 차례로 써요. 제목들만 뽑으면 목차가 되는지 확인해 볼게요.

from bs4 import BeautifulSoup

page = """
<h1>파이썬 시작하기</h1>
<h2>설치</h2><h3>윈도</h3><h3>맥</h3>
<h2>첫 코드</h2><h4>자주 하는 실수</h4>
"""
prev = 0
for h in BeautifulSoup(page, "html.parser").find_all(["h1", "h2", "h3", "h4", "h5", "h6"]):
    level = int(h.name[1])
    warn = "   ← 단계를 건너뜀" if level > prev + 1 else ""
    print("  " * (level - 1) + f"{h.name}: {h.get_text()}{warn}")
    prev = level
h1: 파이썬 시작하기
  h2: 설치
    h3: 윈도
    h3: 맥
  h2: 첫 코드
      h4: 자주 하는 실수   ← 단계를 건너뜀

h2 바로 아래에 h4가 왔어요. 글씨를 조금 작게 하고 싶어서 h4를 고른 거라면, h3를 쓰고 크기는 CSS로 바꾸는 게 맞아요. 제목을 훑어 듣는 사람에게는 사라진 h3가 "중간에 빠진 장"처럼 들리거든요.

누구나 쓸 수 있게

누구나 불편 없이 쓸 수 있게 만드는 것을 접근성이라고 해요. 거창한 기술보다 작은 습관이 대부분이에요. 흔한 실수 세 가지를 찾아내는 검사기를 만들어 볼게요.

from bs4 import BeautifulSoup

page = """
<img src="logo.png">
<img src="chart.png" alt="2026년 월별 방문자 수 막대그래프">
<img src="line.png" alt="">
<label for="email">이메일</label><input id="email" type="email">
<input type="password">
<a href="/guide">여기</a>를 누르세요. <a href="/price">요금 안내</a>
"""
soup = BeautifulSoup(page, "html.parser")
labels = {lab.get("for") for lab in soup.find_all("label")}
for img in soup.find_all("img"):
    if img.get("alt") is None:
        print("설명 없는 이미지:", img["src"])
for inp in soup.find_all("input"):
    if inp.get("id") not in labels:
        print("이름표 없는 입력칸:", inp.get("type"))
for a in soup.find_all("a"):
    if a.get_text(strip=True) in ("여기", "클릭", "더보기"):
        print("뜻을 알 수 없는 링크:", a.get_text(), "→", a["href"])
설명 없는 이미지: logo.png
이름표 없는 입력칸: password
뜻을 알 수 없는 링크: 여기 → /guide
  • 이미지에는 alt를 써요. 이미지를 볼 수 없는 사람에게 읽어 줄 설명이에요. 회선이 느려 이미지가 안 뜰 때 대신 보이고, 검색 엔진도 이 글로 이미지의 내용을 알아요. 그래프라면 무엇을 보여 주는 그래프인지 적어요. 꾸미기만 하는 이미지는 alt=""처럼 비워 두는 게 정답이에요. 그래서 검사기도 line.png는 통과시켰어요. alt 속성 자체가 없으면 화면 낭독기가 파일 이름을 읽어 버리기도 해요.
  • 입력칸에는 이름표를 붙여요. label의 for와 입력칸의 id를 같게 하면 둘이 이어져요. 화면 낭독기가 "이메일, 입력칸"이라고 읽어 주고, 이름표 글자를 눌러도 입력칸이 선택돼요. 칸 안에 흐리게 적는 안내 글(placeholder)은 입력을 시작하면 사라져서 이름표를 대신하지 못해요.
  • 링크 글자만 읽어도 어디로 가는지 알게 써요. 화면 낭독기 사용자는 링크만 모아 듣기도 하는데, "여기, 여기, 더보기"만 들리면 어디로 가는지 알 수 없어요. "요금 안내"처럼 써요.

이 밖에 lang 속성, 글자와 배경의 색 대비(CSS 강의에서 다뤄요), 마우스 없이 Tab 키만으로 모든 기능을 쓸 수 있는지가 기본 점검 항목이에요.

특수 문자 쓰기

HTML에서 <는 태그의 시작이라서, 글자 그대로 보여 주려면 &lt;처럼 바꿔 적어야 해요. >는 &gt;, &는 &amp;, 따옴표는 &quot;예요. 이건 모양의 문제가 아니라 안전의 문제이기도 해요.

import html
from bs4 import BeautifulSoup

comment = '<b>3 < 5 & "최고"</b>'
print("그대로 넣으면:", BeautifulSoup(comment, "html.parser").find("b") is not None)
safe = html.escape(comment)
print("바꾼 글자:", safe)
print("화면에 보이는 글:", BeautifulSoup(f"<p>{safe}</p>", "html.parser").get_text())
그대로 넣으면: True
바꾼 글자: &lt;b&gt;3 &lt; 5 &amp; &quot;최고&quot;&lt;/b&gt;
화면에 보이는 글: <b>3 < 5 & "최고"</b>

누군가 댓글에 쓴 글을 그대로 페이지에 넣으면, 그 안의 <b>가 진짜 태그가 돼 버려요. 굵은 글씨 정도면 다행이지만, 같은 방법으로 남의 페이지에 스크립트를 심을 수도 있어요. 사용자가 입력한 글은 반드시 바꿔 적어서 넣어야 해요. 바꿔 적은 글은 화면에서 원래 글자 그대로 보여요. 이 공격(XSS)은 보안 트랙에서 자세히 다뤄요.

실습

  1. 기본 뼈대를 index.html로 저장하고 브라우저로 열어 보세요. title의 글을 바꾸고 새로 고침하면 어디가 바뀌나요?
  2. 자주 가는 사이트에서 Ctrl+U로 HTML 원문을 열고, head 안의 title과 description을 찾아보세요.
  3. 개발자 도구(F12)의 Elements 탭에서 아무 글자나 더블클릭해서 고쳐 보세요. 새로 고침하면 어떻게 되나요? 왜 그럴까요?
  4. 접근성 검사기에 "글자가 없는 버튼"(아이콘만 든 button)을 찾는 검사를 더해 보세요.
  5. 내가 쓴 블로그 글이나 자주 보는 글 한 편의 HTML을 저장해서, 제목 목차 예제로 단계를 건너뛴 곳이 있는지 확인해 보세요.

자주 하는 실수

  • 닫는 태그를 빼먹거나 엇갈리게 닫는다. 브라우저가 짐작해서 고쳐 주지만, 고친 결과가 내 의도와 다를 수 있어요. W3C 검사기(validator.w3.org)에 붙여 넣으면 잘못된 곳을 알려 줘요.
  • 글씨 크기를 보고 제목 태그를 고른다. 제목 태그는 목차의 단계예요. 크기는 CSS로 정해요.
  • 모든 것을 div로 만든다. 뜻을 담은 태그가 있으면 그것부터 써요.
  • 이미지의 alt를 빼먹거나 파일 이름을 적는다. 내용을 설명하고, 꾸밈용이면 비워 둬요.
  • charset을 빼서 한글이 깨진다. <meta charset="utf-8">은 head의 맨 앞에 둬요.
  • 줄을 바꾸려고 엔터를 여러 번 친다. HTML은 공백을 합쳐요. 문단은 p로 나눠요.

점검 문제

  1. HTML이 프로그래밍 언어가 아니라 표시 언어라는 건 무슨 뜻인가요?
  2. <a href="/price">요금 안내</a>에서 요소, 속성, 내용은 각각 무엇인가요?
  3. <meta charset="utf-8">이 없으면 어떤 일이 생길 수 있나요?
  4. DOM이란 무엇이고, 누가 쓰나요?
  5. div 대신 main, nav, article 같은 태그를 쓰면 좋은 점 두 가지는?
  6. 꾸밈용 이미지의 alt는 어떻게 쓰나요?
  7. 사용자가 입력한 글을 페이지에 넣을 때 <를 &lt;로 바꿔야 하는 이유는?

정답

  1. 계산이나 조건 판단을 하지 않고, 글의 각 부분에 "제목", "링크" 같은 이름표를 붙여 구조를 표시하는 언어라는 뜻이에요.
  2. 전체가 링크 요소이고, href="/price"가 속성, "요금 안내"가 내용이에요.
  3. 브라우저가 글자를 다른 인코딩으로 읽어서 한글이 깨질 수 있어요.
  4. 브라우저가 HTML을 읽어 만든 나무 구조예요. CSS는 이 나무에서 요소를 골라 꾸미고, 자바스크립트는 이 나무를 고쳐 화면을 바꾸고, 스크래핑 도구는 이 나무에서 원하는 부분을 찾아요.
  5. 화면 낭독기가 본문으로 바로 가거나 구조를 읽어 줄 수 있고, 검색 엔진과 스크래핑 도구가 무엇이 본문이고 제목인지 정확히 알 수 있어요. 코드를 다시 볼 때 구조가 한눈에 보이는 것도 장점이에요.
  6. alt=""처럼 비워 둬요. 그러면 화면 낭독기가 건너뛰어요.
  7. 그대로 넣으면 글 속의 태그가 진짜 태그로 동작해서, 남이 페이지에 스크립트를 심는 공격(XSS)이 가능해지기 때문이에요.

다음 강의

뼈대를 세웠으니 이제 꾸밀 차례예요. 다음 강의에서는 CSS로 색과 글꼴을 정하고, 요소를 원하는 자리에 배치하고, 휴대폰과 컴퓨터 화면 모두에서 보기 좋은 반응형 레이아웃을 만드는 법을 배워요.